v1

latestOpenAPI 3.1.02026-08-06209117239.7 KB

memories

Search memories

Search memories with semantic similarity.

post/memories/search

Query parameters

space_idstring nullable

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

Request body

querystring required

Search query text

limitinteger nullable

Maximum number of results

filter_tagsstring[] nullable

Filter by tags

filter_sourcestring nullable

Filter by source

min_importanceinteger nullable

Minimum importance

space_idstring nullable

Space to search in (omit for all spaces)

Example request

{
  "filter_tags": [
    "learning",
    "important"
  ],
  "limit": 5,
  "min_importance": 3,
  "query": "What did I learn about machine learning?",
  "space_id": "space_12345678"
}

Response

List of matching memories

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