GoodMemGoodMem
ReferenceAPIREST APIService Identities

Delete a service identity

DELETE /v1/service-identities/{id}: Permanently soft-deletes the principal.

DELETE
/v1/service-identities/{id}

Permanently soft-deletes the principal. Its stored credentials remain audit records but can no longer authenticate because their subject is deleted. Repeating an authorized delete succeeds without rewriting audit data.

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

Response Body

Service identity deleted or already deleted

Example Request
curl -X DELETE 'https://your-goodmem-server.example.com/v1/service-identities/550e8400-e29b-41d4-a716-446655440000' \  -H 'GoodMem-Timeout-Ms: 30000'
Example Response
Empty