Deployments.ai Docs
Command reference

deployments brain-grant

Human, service, and agent Brain grants

CommandSummary
deployments brain-grant listList Brain grants
deployments brain-grant createCreate a Brain grant
deployments brain-grant revokeRevoke a Brain grant

deployments brain-grant list

List Brain grants.

deployments brain-grant list <brain>
  • Calls GET /v1/brains/{brainId}/grants (SDK listBrainGrants).
  • Needs an organization: --org or the saved context.
  • Paginated. --page-size sets the page size; pass the returned cursor as --cursor for the next page.
FlagTypeRequiredDefaultDescription
--cursorstring (cursor)Pagination cursor
--page-sizestring (number)Page size
<brain>positionalyesBrain ID

Also accepts the global flags.

deployments brain-grant create

Create a Brain grant.

deployments brain-grant create <brain> --permission <permission> --target <json>
  • Calls POST /v1/brains/{brainId}/grants (SDK createBrainGrant).
  • Needs an organization: --org or the saved context.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
<brain>positionalyesBrain ID
--permissionstringyesBrain permission
--targetstring (json)yesGrant target identity

Also accepts the global flags.

deployments brain-grant revoke

Revoke a Brain grant.

deployments brain-grant revoke <brain> <grant> --expected-version <number>
  • Calls DELETE /v1/brains/{brainId}/grants/{grantId} (SDK revokeBrainGrant).
  • Needs an organization: --org or the saved context.
  • Destructive. Live runs ask for confirmation; pass --yes in scripts or with --json.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
<brain>positionalyesBrain ID
<grant>positionalyesBrain grant ID
--expected-versionstring (number)yesCurrent grant version

Also accepts the global flags.

On this page