Brains
Mount a Brain on an agent deployment
POST /v1/brains/{brainId}/mounts · SDK createBrainMount · CLI deployments brain-mount create
POST
Requires brains:admin.
tenantJwtheader
AuthorizationBearer <token>Tenant JWT carrying organization, project, and environment claims.
brainId*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$x-deployments-organization*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$idempotency-key*stringLimited to 500 UTF-8 bytes.
Length
1 <= length <= 500application/json- body
agentDefinitionId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$agentDeploymentId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$environmentId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$permission*stringValue in
"read""read-write"projectId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$BrainMountResponse
application/json- response
agentDefinitionId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$agentDeploymentId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$brainId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$createdAt*stringenvironmentId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$id*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$organizationId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$ownershipGeneration?integerRange
0 <= valuepermission*stringValue in
"read""read-write"projectId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$revokedAt?stringstatus*stringValue in
"active""revoked"updatedAt*stringversion*integerRange
0 <= valuecurl -X POST "https://example.com/v1/brains/string/mounts" \ -H "x-deployments-organization: string" \ -H "idempotency-key: string" \ -H "Content-Type: application/json" \ -d '{ "agentDefinitionId": "string", "agentDeploymentId": "string", "environmentId": "string", "permission": "read", "projectId": "string" }'{ "agentDefinitionId": "string", "agentDeploymentId": "string", "brainId": "string", "createdAt": "string", "environmentId": "string", "id": "string", "organizationId": "string", "ownershipGeneration": 0, "permission": "read", "projectId": "string", "revokedAt": "string", "status": "active", "updatedAt": "string", "version": 0}