Deployments.ai Docs
Memory

Search memory with an evidence retrieval strategy

POST /v1/memory/evidence/strategy-search · SDK strategySearchMemories · CLI deployments memory strategy-search

POST
/v1/memory/evidence/strategy-search

Requires memory:admin. A suspended organization can still call it.

Authorization

tenantJwt
headerAuthorizationBearer <token>

Tenant JWT carrying organization, project, and environment claims.

Header Parameters

x-deployments-environment?string

Optional tenant consistency assertion; when supplied, it must match the authenticated credential.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-organization?string

Optional tenant consistency assertion; when supplied, it must match the authenticated credential.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-project?string

Optional tenant consistency assertion; when supplied, it must match the authenticated credential.

Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
idempotency-key?string

Limited to 500 UTF-8 bytes.

Length1 <= length <= 500

Request Body

application/json
  1. body
query*string
searchKeys?array<string>
Itemsitems <= 50
topK?integer
Range1 <= value <= 45
memorySpaceIds*array<>
Items1 <= items <= 20
space?string
Match^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$
strategy*string
Value in"dense-open-search-ann-control-v1""dense-exact-control-v1""hybrid-rerank-v1""hybrid-rrf-v1"

Response Body

MemoryObjectResponse

application/json
  1. response
curl -X POST "https://example.com/v1/memory/evidence/strategy-search" \  -H "Content-Type: application/json" \  -d '{    "query": "string",    "memorySpaceIds": [      "string"    ],    "strategy": "dense-open-search-ann-control-v1"  }'
{}