Get a service identity
GET /v1/service-identities/{id}: Returns a service identity after applying READ_SERVICE_IDENTITY authority.
Returns a service identity after applying READ_SERVICE_IDENTITY authority. includeDeleted permits an authorized caller to inspect a permanent tombstone; it does not grant additional authority.
ApiKeyAuthx-api-key<token>id*stringService-identity UUID
includeDeleted?booleanPermit an authorized read of a permanent tombstone
falseGoodMem-Timeout-Ms?integerOptional 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.
int641 <= value <= 86400000Service identity returned
application/json- response
A durable production workload identity. Credentials, grants, and roles are separate resources and are not included.
serviceIdentityId*stringOUTPUT_ONLY; immutable service-identity UUID.
uuid"550e8400-e29b-41d4-a716-446655440000"displayName*stringOUTPUT_ONLY; unique operator-facing display name.
"production-search"description?|OUTPUT_ONLY; optional operator description.
ownerPrincipalId*stringOUTPUT_ONLY; current administrative owner principal UUID.
uuidcreatorPrincipalId*stringOUTPUT_ONLY; immutable HUMAN creator-principal UUID.
uuidlabels*OUTPUT_ONLY; mutable labels. At most 20 entries; keys and values contain at most 255 characters; keys use [a-z0-9._-].
properties <= 20{ "environment": "production", "team": "search"}deletedAt?|OUTPUT_ONLY; permanent deletion time in milliseconds, absent while active.
int641620200000000deletedById?|OUTPUT_ONLY; exact deleting actor UUID, absent while active.
uuidcreatedAt*integerOUTPUT_ONLY; creation time in milliseconds since the epoch.
int641620000000000updatedAt*integerOUTPUT_ONLY; most recent mutation time in milliseconds since the epoch.
int641620100000000createdById*stringOUTPUT_ONLY; exact creating actor UUID.
uuidupdatedById*stringOUTPUT_ONLY; exact actor UUID for the most recent mutation.
uuidcurl -X GET 'https://your-goodmem-server.example.com/v1/service-identities/550e8400-e29b-41d4-a716-446655440000' \ -H 'GoodMem-Timeout-Ms: 30000'{ "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"}