Deployments.ai Docs
Command reference

deployments memory-space-grant

Agent access to governed memory spaces

CommandSummary
deployments memory-space-grant listList memory space grants
deployments memory-space-grant createGrant an agent access to a memory space
deployments memory-space-grant updateChange a memory space grant permission
deployments memory-space-grant revokeRevoke a memory space grant

deployments memory-space-grant list

List memory space grants.

deployments memory-space-grant list
  • Calls GET /v1/memory-space-grants (SDK listMemorySpaceGrants).
  • 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
--agent-definition-idstringFilter by agent definition ID
--memory-space-idstringFilter by memory space ID
--statusstringactive, 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 (SDK createMemorySpaceGrant).
  • 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
--agent-definition-idstringyesAgent definition ID
--memory-space-idstringyesMemory space ID
--permissionstringyesread 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} (SDK updateMemorySpaceGrant).
  • 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
<id>positionalyesResource ID
--permissionstringyesread 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} (SDK revokeMemorySpaceGrant).
  • 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

Also accepts the global flags.

On this page