GoodMemGoodMem
ReferenceAPIREST APIAdmin

Transfer GoodMem instance ownership

POST /v1/admin:transferInstanceOwnership: Transfers the singleton GoodMem instance to another active human principal.

POST
/v1/admin:transferInstanceOwnership

Transfers the singleton GoodMem instance to another active human principal. Only the current instance owner may invoke this operation; ADMIN, MANAGE_ACCESS, and ordinary grants are insufficient. Ownership and the synthetic ROOT assignment move atomically. All ordinary roles, including ADMIN, remain unchanged. No credential is created or returned. After an unknown outcome, read the current owner before retrying.

Authorization

ApiKeyAuth
headerx-api-key<token>

Header Parameters

GoodMem-Timeout-Ms?integer

Optional waiting budget in milliseconds, measured from REST servlet ingress and shared across all internal gRPC calls. Supply one decimal integer from 1 to 86400000. Omission adds no deadline. Existing shorter deadlines still apply. Expiry returns HTTP 504 before streaming starts; after streaming starts, no successful completion event is sent. Use SSE or opt into GoodMem-Stream-Terminal for an explicit terminal outcome. Retrieval work is cooperatively cancelled. An accepted mutation may still commit after timeout or disconnect; a failed response does not imply rollback.

Formatint64
Range1 <= value <= 86400000

Request Body

Destination human owner principal

application/json
  1. body

Names the principal that will become the resource owner.

newOwnerId*string

Existing principal UUID that will become the new owner.

Formatuuid
Example"550e8400-e29b-41d4-a716-446655440000"

Response Body

Instance ownership transferred

application/json
  1. response

The singleton GoodMem instance after its ownership transfer completes.

instance*

Updated singleton instance and ownership audit metadata.

Example Request
curl -X POST 'https://your-goodmem-server.example.com/v1/admin:transferInstanceOwnership' \  -H 'GoodMem-Timeout-Ms: 30000' \  -H 'Content-Type: application/json' \  -d '{  "newOwnerId": "550e8400-e29b-41d4-a716-446655440000"}'
Example Response
{  "instance": {    "instanceId": "550e8400-e29b-41d4-a716-446655440000",    "ownerId": "650e8400-e29b-41d4-a716-446655440001",    "createdAt": 1651483320000,    "updatedAt": 1651486920000,    "createdById": "750e8400-e29b-41d4-a716-446655440002",    "updatedById": "850e8400-e29b-41d4-a716-446655440003"  }}