Brains
Revoke a Brain grant
DELETE /v1/brains/{brainId}/grants/{grantId} · SDK revokeBrainGrant · CLI deployments brain-grant revoke
DELETE
Requires brains:admin. A suspended organization can still call it.
tenantJwtheader
AuthorizationBearer <token>Tenant JWT carrying organization, project, and environment claims.
brainId*stringMatch
^[0-7][0-9A-HJKMNP-TV-Z]{25}$grantId*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
expectedVersion*integerRange
0 <= valueBrainGrantResponse
application/json- response
brainId*stringMatch
^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$createdAt*stringid*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
"curator""owner""read""read-write""reader""writer"revokedAt?stringstatus*stringValue in
"active""revoked"target*|||updatedAt*stringversion*integerRange
0 <= valuecurl -X DELETE "https://example.com/v1/brains/string/grants/string" \ -H "x-deployments-organization: string" \ -H "idempotency-key: string" \ -H "Content-Type: application/json" \ -d '{ "expectedVersion": 0 }'{ "brainId": "string", "createdAt": "string", "id": "string", "organizationId": "string", "ownershipGeneration": 0, "permission": "curator", "revokedAt": "string", "status": "active", "target": { "principalId": "string", "type": "principal" }, "updatedAt": "string", "version": 0}