Brains
Search source-grounded Brain evidence
POST /v1/brains/search · SDK searchBrains · CLI deployments brain search
POST
Requires brains:read. A suspended organization can still call it.
tenantJwtheader
AuthorizationBearer <token>Tenant JWT carrying organization, project, and environment claims.
x-deployments-organization*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-project*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-environment*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$idempotency-key*stringLimited to 500 UTF-8 bytes.
Length
1 <= length <= 500application/json- body
brainIds*array<>limit?integerRange
1 <= value <= 50query*stringLength
length <= 8000BrainSearchResponse
application/json- response
queryAttemptId*stringMatch
^[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" } ]}