Deployments.ai Docs
Brains

Search source-grounded Brain evidence

POST /v1/brains/search · SDK searchBrains · CLI deployments brain search

POST
/v1/brains/search

Requires brains:read. A suspended organization can still call it.

Authorization

tenantJwt
headerAuthorizationBearer <token>

Tenant JWT carrying organization, project, and environment claims.

Header Parameters

x-deployments-organization*string
Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-project*string
Match^[0-7][0-9A-HJKMNP-TV-Z]{25}$
x-deployments-environment*string
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
brainIds*array<>
limit?integer
Range1 <= value <= 50
query*string
Lengthlength <= 8000

Response Body

BrainSearchResponse

application/json
  1. response
queryAttemptId*string
Match^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$
results*array<>
curl -X POST "https://example.com/v1/brains/search" \  -H "x-deployments-organization: string" \  -H "x-deployments-project: string" \  -H "x-deployments-environment: string" \  -H "idempotency-key: string" \  -H "Content-Type: application/json" \  -d '{    "brainIds": [      "string"    ],    "query": "string"  }'
{  "queryAttemptId": "string",  "results": [    {      "citation": {        "brainId": "string",        "chunkId": "string",        "coordinates": {          "end": 0,          "kind": "media-timestamp",          "start": 0        },        "documentId": "string",        "documentVersionId": "string",        "renditionId": "string",        "sourceId": "string"      },      "excerpt": "string",      "score": 0,      "sensitivity": "confidential",      "title": "string"    }  ]}