Deployments.ai Docs
Command reference

deployments memory-space

Governed memory spaces

CommandSummary
deployments memory-space createCreate a memory space
deployments memory-space listList memory spaces
deployments memory-space showShow a memory space
deployments memory-space archiveArchive a memory space

deployments memory-space create

Create a memory space.

deployments memory-space create --name <name>
  • Calls POST /v1/memory-spaces (SDK createMemorySpace).
  • Needs an environment: --env or the saved context.
  • Sends an idempotency key. The CLI generates one per run; pass --idempotency-key to retry safely.
FlagTypeRequiredDefaultDescription
--namestringyesResource name
--descriptionstringResource description
--kindstringMemory space kind
--workspace-idstringWorkspace ID for workspace-owned memory
--retention-daysstring (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 (SDK listMemorySpaces).
  • Needs an environment: --env 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

Also accepts the global flags.

deployments memory-space show

Show a memory space.

deployments memory-space show <id>
FlagTypeRequiredDefaultDescription
<id>positionalyesResource 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} (SDK archiveMemorySpace).
  • Needs an environment: --env 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
<id>positionalyesResource ID
--reasonstringReason for this operation

Also accepts the global flags.

On this page