Command reference
deployments memory-space-grant
Agent access to governed memory spaces
| Command | Summary |
|---|---|
deployments memory-space-grant list | List memory space grants |
deployments memory-space-grant create | Grant an agent access to a memory space |
deployments memory-space-grant update | Change a memory space grant permission |
deployments memory-space-grant revoke | Revoke a memory space grant |
deployments memory-space-grant list
List memory space grants.
deployments memory-space-grant list- Calls
GET /v1/memory-space-grants(SDKlistMemorySpaceGrants). - Needs an environment:
--envor 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 | ||
--agent-definition-id | string | Filter by agent definition ID | ||
--memory-space-id | string | Filter by memory space ID | ||
--status | string | active, revoked, or all |
Also accepts the global flags.
deployments memory-space-grant create
Grant an agent access to a memory space.
deployments memory-space-grant create --agent-definition-id <agent-definition-id> --memory-space-id <memory-space-id> --permission <permission>- Calls
POST /v1/memory-space-grants(SDKcreateMemorySpaceGrant). - Needs an environment:
--envor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--agent-definition-id | string | yes | Agent definition ID | |
--memory-space-id | string | yes | Memory space ID | |
--permission | string | yes | read or read-write |
Also accepts the global flags.
deployments memory-space-grant update
Change a memory space grant permission.
deployments memory-space-grant update <id> --permission <permission>- Calls
PATCH /v1/memory-space-grants/{grantId}(SDKupdateMemorySpaceGrant). - Needs an environment:
--envor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--permission | string | yes | read or read-write |
Also accepts the global flags.
deployments memory-space-grant revoke
Revoke a memory space grant.
deployments memory-space-grant revoke <id>- Calls
DELETE /v1/memory-space-grants/{grantId}(SDKrevokeMemorySpaceGrant). - Needs an environment:
--envor 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 |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.