System Transfer Ownership

goodmem system transfer-ownership

Transfer ownership of the GoodMem instance

Synopsis

Transfer the singleton GoodMem instance to a different active human principal.

Instance ownership transfer is constitutional authority held only by the current instance owner. An ADMIN role, MANAGE_ACCESS, or any ordinary role or grant is insufficient. A scoped API key must also have a matching immutable instance-transfer ceiling. The transfer moves the synthetic ROOT role mirror but leaves every ordinary role assignment, including ADMIN, unchanged.

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

goodmem system transfer-ownership [flags]

Examples

  # Transfer the instance and print its updated ownership metadata as JSON
  goodmem system transfer-ownership \
    --new-owner 123e4567-e89b-12d3-a456-426614174001

  # Print only the singleton instance UUID
  goodmem system transfer-ownership \
    --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 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)