WellMarked Docs
API referenceKeys

Revoke an API key (stops working immediately)

Revoke a key on the authenticated account. The key stops authenticating immediately — there is no grace period, so revoke only after the replacement is deployed.

DELETE
/keys/{key_id}

Revoke a key on the authenticated account. The key stops authenticating immediately — there is no grace period, so revoke only after the replacement is deployed.

Revocation is permanent and cannot be undone; mint a new key instead. The row remains listable with revoked_at set, so the audit trail survives. Unmetered.

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer wm_.... Keys are wm_ followed by 40 hex characters. Create one with POST /register (free, no auth) or POST /keys.

In: header

Path Parameters

key_id*Key Id
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://api.wellmarked.io/keys/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Authorization: Bearer wm_your_api_key_here"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "revoked_at": "2019-08-24T14:15:22Z"}