Memory
Search approved memory
POST /v1/memory/search · SDK searchMemories · CLI deployments memory search
POST
Requires memory:read. A suspended organization can still call it.
tenantJwtheader
AuthorizationBearer <token>Tenant JWT carrying organization, project, and environment claims.
x-deployments-environment?stringOptional tenant consistency assertion; when supplied, it must match the authenticated credential.
Match
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-organization?stringOptional tenant consistency assertion; when supplied, it must match the authenticated credential.
Match
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-project?stringOptional tenant consistency assertion; when supplied, it must match the authenticated credential.
Match
^[0-7][0-9A-HJKMNP-TV-Z]{25}$idempotency-key?stringLimited to 500 UTF-8 bytes.
Length
1 <= length <= 500application/json- body
query*stringsearchKeys?array<string>Items
items <= 50topK?integerRange
1 <= value <= 45memorySpaceIds*array<>Items
1 <= items <= 20space?stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$MemoryObjectResponse
application/json- response
curl -X POST "https://example.com/v1/memory/search" \ -H "Content-Type: application/json" \ -d '{ "query": "string", "memorySpaceIds": [ "string" ] }'{}