Create a service identity
POST /v1/service-identities: Creates one production-workload identity owned by the authenticated human. No API key, role, grant, or authentication mapping is created implicitly.
Creates one production-workload identity owned by the authenticated human. No API key, role, grant, or authentication mapping is created implicitly.
ApiKeyAuthx-api-key<token>GoodMem-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 <= 86400000application/json- body
Creates a service identity owned by the authenticated human. It does not create credentials, roles, or grants.
serviceIdentityId?|Optional client-provided UUID; generated by the server when omitted.
uuid"550e8400-e29b-41d4-a716-446655440000"displayName*stringGlobally unique, nonblank operator-facing name.
1 <= length <= 255"production-search"description?|Optional operator description.
"Identity used by the production search workload"labels?|Optional labels for organization and filtering. At most 20 entries; keys and values contain at most 255 characters; keys use [a-z0-9._-].
properties <= 20{ "environment": "production", "team": "search"}Service identity created
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 POST 'https://your-goodmem-server.example.com/v1/service-identities' \ -H 'GoodMem-Timeout-Ms: 30000' \ -H 'Content-Type: application/json' \ -d '{ "serviceIdentityId": "550e8400-e29b-41d4-a716-446655440000", "displayName": "production-search", "description": "Identity used by the production search workload", "labels": { "environment": "production", "team": "search" }}'{ "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"}