GoodMemGoodMem
ReferenceAPIREST APIAPI Keys

Delete an API key

DELETE /v1/apikeys/{id}: Permanently revokes an API key and immediately rejects it for future authentication.

Permanently revokes an API key and immediately rejects it for future authentication. The durable credential and audit history remain stored. This operation requires DELETE_API_KEY and records the revocation time and actor; it cannot be undone. PUT /v1/apikeys/{id} with status=INACTIVE performs the same protected lifecycle transition.

DELETE
/v1/apikeys/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idstring

The UUID of the API key to delete

Response Body

curl -X DELETE "https://your-goodmem-server.example.com/v1/apikeys/550e8400-e29b-41d4-a716-446655440000"
Empty
Empty
Empty
Empty
Empty

Create a new API key

POST /v1/apikeys: Issues a new API key and returns its raw value exactly once.

Get an API key

GET /v1/apikeys/{id}: Returns complete non-secret metadata for one existing credential after requiring effective READ_API_KEY authority.