Command reference
deployments brain-mount
Deployment Brain mounts
| Command | Summary |
|---|---|
deployments brain-mount list | List Brain mounts |
deployments brain-mount create | Mount a Brain on an agent deployment |
deployments brain-mount revoke | Revoke a Brain mount |
deployments brain-mount list
List Brain mounts.
deployments brain-mount list <brain>- Calls
GET /v1/brains/{brainId}/mounts(SDKlistBrainMounts). - Needs an organization:
--orgor the saved context. - Paginated.
--page-sizesets the page size; pass the returned cursor as--cursorfor the next page.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--cursor | string (cursor) | Pagination cursor | ||
--page-size | string (number) | Page size | ||
<brain> | positional | yes | Brain 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(SDKcreateBrainMount). - Needs an organization:
--orgor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<brain> | positional | yes | Brain ID | |
--agent-definition-id | string | yes | Agent definition ID | |
--agent-deployment-id | string | yes | Agent deployment ID | |
--environment-id | string | yes | Environment ID | |
--permission | string | yes | Mount permission | |
--project-id | string | yes | Project 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}(SDKrevokeBrainMount). - Needs an organization:
--orgor the saved context. - Destructive. Live runs ask for confirmation; pass
--yesin scripts or with--json. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<brain> | positional | yes | Brain ID | |
<mount> | positional | yes | Brain mount ID | |
--expected-version | string (number) | yes | Current mount version |
Also accepts the global flags.