GoodMemGoodMem
ReferenceAPIREST APIService Identities

Transfer service-identity ownership

POST /v1/service-identities/{id}:transferOwnership: Transfers administrative ownership to another active principal.

POST
/v1/service-identities/{id}:transferOwnership

Transfers administrative ownership to another active principal. A service identity cannot own itself. The service identity's subject, immutable creator, credentials, grants, and roles are unchanged.

Authorization

ApiKeyAuth
headerx-api-key<token>

Path Parameters

id*string

Service-identity UUID

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

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

Ownership transferred

application/json
  1. response

The service identity after its administrative ownership transfer.

serviceIdentity*

OUTPUT_ONLY; updated service identity.

Example Request
curl -X POST 'https://your-goodmem-server.example.com/v1/service-identities/550e8400-e29b-41d4-a716-446655440000:transferOwnership' \  -H 'GoodMem-Timeout-Ms: 30000' \  -H 'Content-Type: application/json' \  -d '{  "newOwnerId": "550e8400-e29b-41d4-a716-446655440000"}'
Example Response
{  "serviceIdentity": {    "serviceIdentityId": "550e8400-e29b-41d4-a716-446655440000",    "displayName": "production-search",    "description": "string",    "ownerPrincipalId": "c8b7819f-5f12-46fd-a2bb-632aece82193",    "creatorPrincipalId": "9dd98014-def4-41d6-819d-7db1f82d4d60",    "labels": {      "environment": "production",      "team": "search"    },    "deletedAt": 1620200000000,    "deletedById": "8ef578ad-7f1e-4656-b48b-b1b4a9aaa1cb",    "createdAt": 1620000000000,    "updatedAt": 1620100000000,    "createdById": "e13e432a-5323-4484-a91d-b5969bc564d9",    "updatedById": "d8bc6076-4141-4a88-80b9-0eb31643066f"  }}