GoodMemGoodMem
ReferenceAPIREST APIUsers

Delete a human user

DELETE /v1/users/{id}: Permanently soft-deletes the user and invalidates credentials acting for that subject.

Permanently soft-deletes the user and invalidates credentials acting for that subject. The GoodMem instance owner cannot be deleted; transfer ownership first. Repeating an authorized delete succeeds without rewriting audit data.

DELETE
/v1/users/{id}
x-api-key<token>

In: header

Path Parameters

idstring

User 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

curl -X DELETE "https://your-goodmem-server.example.com/v1/users/550e8400-e29b-41d4-a716-446655440000" \  -H "GoodMem-Timeout-Ms: 30000"
Empty
Empty
Empty
Empty
Empty
Empty
Empty
Empty
Empty
Empty