GoodMemGoodMem
ReferenceAPIREST APIAdmin

Transfer GoodMem instance ownership

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

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.

POST
/v1/admin:transferInstanceOwnership
x-api-key<token>

In: header

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

Destination human owner principal

newOwnerIdstring

Existing principal UUID that will become the new owner.

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

Response Body

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"  }'
{
  "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"
  }
}
Empty
Empty
Empty
Empty
Empty
Empty
Empty