v171

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0726249111.7 MB
Memory Stores

Create memory store

post/v2/memory-stores

Request body

keystring required

The unique key of the memory store. The key is unique and inmmutable and cannot be repeated within the same workspace.

descriptionstring required

The description of the memory store. Be as precise as possible to help the AI to understand the purpose of the memory store.

ttlnumber nullable

The default time to live of every memory document created within the memory store. Useful to control if the documents in the memory should be store for short or long term.

pathstring required

Entity storage path.

With workspace-level API keys, use the format project/folder/subfolder/.... The first element identifies the project, followed by nested folders (auto-created as needed). Example: Default/agents.

With project-level API keys, the project is predetermined by the API key, so the path is relative to that project. Example: agents. For backward compatibility, a leading project name is ignored when it matches the scoped project.

Example request

{
  "path": "Default"
}

Response

Memory store successfully created with the specified configuration.

_idstring required

The unique identifier of the memory store

keystring required

The unique key of the memory store. The key is unique and inmmutable and cannot be repeated within the same workspace.

descriptionstring required

The description of the memory store. Be as precise as possible to help the AI to understand the purpose of the memory store.

created_by_idstring nullable

The user ID of the creator

updated_by_idstring nullable

The user ID of the last updater

createdstring required

The creation date of the memory store

updatedstring required

The last update date of the memory store

ttlnumber nullable

The default time to live of every memory document created within the memory store. Useful to control if the documents in the memory should be store for short or long term.