Brains
Ask a cited question across authorized Brains
POST /v1/brains/ask · SDK askBrains · CLI deployments brain ask
POST
Requires brains:read.
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<>evidenceLimit?integerRange
1 <= value <= 50question*stringLength
length <= 8000BrainAskResponse
application/json- response
claims*array<>gaps*array<string>queryAttemptId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$usedCitations*array<>curl -X POST "https://example.com/v1/brains/ask" \ -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" ], "question": "string" }'{ "claims": [ { "citationIds": [ "string" ], "text": "string" } ], "gaps": [ "string" ], "queryAttemptId": "string", "usedCitations": [ { "brainId": "string", "chunkId": "string", "coordinates": { "end": 0, "kind": "media-timestamp", "start": 0 }, "documentId": "string", "documentVersionId": "string", "renditionId": "string", "sourceId": "string" } ]}