Command reference
deployments memory-space
Governed memory spaces
| Command | Summary |
|---|---|
deployments memory-space create | Create a memory space |
deployments memory-space list | List memory spaces |
deployments memory-space show | Show a memory space |
deployments memory-space archive | Archive a memory space |
deployments memory-space create
Create a memory space.
deployments memory-space create --name <name>- Calls
POST /v1/memory-spaces(SDKcreateMemorySpace). - 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 |
|---|---|---|---|---|
--name | string | yes | Resource name | |
--description | string | Resource description | ||
--kind | string | Memory space kind | ||
--workspace-id | string | Workspace ID for workspace-owned memory | ||
--retention-days | string (number) | Default retention in days |
Also accepts the global flags.
deployments memory-space list
List memory spaces.
deployments memory-space list- Calls
GET /v1/memory-spaces(SDKlistMemorySpaces). - 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 |
Also accepts the global flags.
deployments memory-space show
Show a memory space.
deployments memory-space show <id>- Calls
GET /v1/memory-spaces/{memorySpaceId}(SDKgetMemorySpace). - Needs an environment:
--envor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments memory-space archive
Archive a memory space.
deployments memory-space archive <id>- Calls
DELETE /v1/memory-spaces/{memorySpaceId}(SDKarchiveMemorySpace). - 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 | |
--reason | string | Reason for this operation |
Also accepts the global flags.