v1

latestOpenAPI 3.1.02026-08-06209117239.7 KB
mcp-integration

Create memory for MCP integration

Create memory in the binding's canonical socket space.

post/api/v1/mcp/memories

Headers

authorizationstring

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

Successful Response

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"
}