GoodMemGoodMem
ReferenceCLISpace

Space Transfer Ownership

Space Transfer Ownership CLI command reference

goodmem space transfer-ownership

Transfer a space to another principal

Synopsis

Transfer a space to a different active human or service principal.

Ownership transfer is constitutional authority. The current space owner, current instance owner, or an instance administrator may transfer a space. A space role or ordinary access-policy grant, including MANAGE_ACCESS, is insufficient. A scoped API key must also have a matching immutable transfer ceiling.

This operation is not idempotent under response semantics. If a timeout or connection failure leaves the outcome unknown, read the space's current owner before retrying.

goodmem space transfer-ownership <space-id> [flags]

Examples

  # Transfer a space and print the updated space as JSON
  goodmem space transfer-ownership 123e4567-e89b-12d3-a456-426614174000 \
    --new-owner 123e4567-e89b-12d3-a456-426614174001

  # Print only the transferred space UUID
  goodmem space transfer-ownership 123e4567-e89b-12d3-a456-426614174000 \
    --new-owner 123e4567-e89b-12d3-a456-426614174001 --format quiet

Options

  -f, --format string      Output format: json, compact, quiet (default "json")
  -h, --help               help for transfer-ownership
      --new-owner string   Required destination human or service principal UUID

Options inherited from parent commands

      --api-key string   API key for authentication (can also be set via GOODMEM_API_KEY environment variable)
      --server string    GoodMem server address (gRPC API)

SEE ALSO