Less boo. More booked. Halloween offer: 30 days free on any paid plan. Claim 30 days freeEvery new account gets one free mailbox for warmup and replies. No domain to buy. See how it works

Skip to content

Revoke a key

API referenceAPI Keys

From the API Keys API reference. Requests use the base URL https://app.warmerly.com/api/v1 and an API key, see Authentication.

text
DELETE /keys/{id}

Revokes (soft-deletes) the key. Revoked keys fail authentication immediately on their next request, there is no grace period, and revocation cannot be undone.

bash
curl -X DELETE https://app.warmerly.com/api/v1/keys/3b1f6e2a-9c4d-4e2a-8b5f-6a2c1d9e0f7b \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
json
{ "revoked": true }

If the key doesn't exist, doesn't belong to you, or has already been revoked, this returns 404:

json
{ "error": { "code": "not_found", "message": "not_found", "details": null } }

You can revoke the key you're currently authenticating with. The revocation takes effect immediately, so any subsequent request with that key (including further calls in the same script) will fail with 401 unauthorized.

Was this page helpful?