Skip to main content
POST
/
api
/
v1
/
memories
/
search
{
  "memories": [
    {
      "memory_id": "<string>",
      "user_id": "<string>",
      "memory": "<string>",
      "topics": [
        "<string>"
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ],
  "total_results": 123,
  "query": "<string>",
  "retrieval_method": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Workspace-Id
string | null

The workspace ID

Body

application/json

Schema for memory search request.

query
string
required

Search query for memories.

user_id
string | null

User ID.

limit
integer | null
default:10

Maximum number of memories to return.

Required range: 1 <= x <= 100
retrieval_method
string | null
default:agentic

Retrieval method: 'agentic', 'agentic_vector', 'agentic_hybrid', 'agentic_keyword', 'vector', 'hybrid', 'keyword', 'last_n', or 'first_n'.

Response

Successful Response

Schema for memory search response.

memories
MemoryResponse · object[]
required

List of matching memories.

total_results
integer
required

Total number of memories found.

query
string
required

The search query used.

retrieval_method
string
required

The retrieval method used.