v1

latestOpenAPI 3.1.02026-08-06209117239.7 KB
memories

Create a new memory

Create a new memory.

post/memories

Query parameters

space_idstring nullable

Space ID to create memory in (defaults to user's default space)

Space ID to create memory in (defaults to user's default space)

Request body

contentstring required

Memory content text

tagsstring[] nullable

Tags for categorizing the memory

sourcestring nullable

Source of the memory

importanceinteger nullable

Importance score (1-10)

categorystring nullable

Memory category within space

metadataobject nullable

Additional metadata

space_idstring nullable

Space ID to create memory in

Response

The created memory

contentstring required

Memory content text

tagsstring[] nullable

Tags for categorizing the memory

sourcestring nullable

Source of the memory

importanceinteger nullable

Importance score (1-10)

categorystring nullable

Memory category within space

metadataobject nullable

Additional metadata

idstring required

Unique identifier

created_atstring date-time required

Creation timestamp

updated_atstring date-time nullable

Last update timestamp

created_by_userstring required

User who created this memory

space_idstring nullable

Space this memory belongs to

space_namestring nullable

Name of the space

tenant_idstring nullable

Legacy tenant identifier

full_contentstring nullable

Complete original content (internal use)

is_chunkboolean

Whether this memory is a chunk of larger content

parent_memory_idstring nullable

ID of parent memory if this is a chunk

chunk_indexinteger nullable

Index of this chunk within parent memory

total_chunksinteger nullable

Total number of chunks in parent memory

chunk_metadataobject nullable

Chunk-specific metadata

Example response

{
  "category": "general",
  "content": "Example memory content",
  "created_at": "2023-04-01T14:30:45.123Z",
  "created_by_user": "user123",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "importance": 5,
  "is_chunk": false,
  "source": "api",
  "space_id": "space_12345678",
  "space_name": "Work Projects",
  "tags": [
    "example",
    "memory"
  ],
  "updated_at": "2023-04-01T14:45:10.456Z"
}