Deployments.ai Docs
Command reference

deployments brain-mount

Deployment Brain mounts

CommandSummary
deployments brain-mount listList Brain mounts
deployments brain-mount createMount a Brain on an agent deployment
deployments brain-mount revokeRevoke a Brain mount

deployments brain-mount list

List Brain mounts.

deployments brain-mount list <brain>
  • Calls GET /v1/brains/{brainId}/mounts (SDK listBrainMounts).
  • 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-mount create

Mount a Brain on an agent deployment.

deployments brain-mount create <brain> --agent-definition-id <agent-definition-id> --agent-deployment-id <agent-deployment-id> --environment-id <environment-id> --permission <permission> --project-id <project-id>
  • Calls POST /v1/brains/{brainId}/mounts (SDK createBrainMount).
  • 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
--agent-definition-idstringyesAgent definition ID
--agent-deployment-idstringyesAgent deployment ID
--environment-idstringyesEnvironment ID
--permissionstringyesMount permission
--project-idstringyesProject ID

Also accepts the global flags.

deployments brain-mount revoke

Revoke a Brain mount.

deployments brain-mount revoke <brain> <mount> --expected-version <number>
  • Calls DELETE /v1/brains/{brainId}/mounts/{mountId} (SDK revokeBrainMount).
  • 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
<mount>positionalyesBrain mount ID
--expected-versionstring (number)yesCurrent mount version

Also accepts the global flags.

On this page