API reference

API reference · API

Make a memory space

POST/v1/memory_spacesAPI key

A space embeds with one model, the operator's default unless named. A 404 at every path while the operator has not turned memory on.

Request body

application/json, optional

Request body fields
FieldTypeWhat it is
namestring or null
userstring or null
metadataobject or null
embedding_modelstringAt most 200 characters.
embedding_dimensionsintegerAt most 9007199254740991.

Example

{}

Answer 200

The space.

Fields of the 200 answer
FieldTypeWhat it is
idstringmsp_ and 24 hex digits.
object"memory_space"
namestring
userstring or null
agent_idinteger or nullSet on an agent's space.
defaultboolean
metadataobject
memory_countinteger
embedding_modelstring
embedding_dimensionsinteger or null
created_atinteger
updated_atinteger

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 404OpenAI shaped error.
  • 503OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter