Revoke Account Key
Revoke one of your active account's account keys. It stops working at once: its next request answers 401, whatever is using it. A revoked key can't be restored; to replace one, create a new key first, switch what uses it, then revoke the old one.
The key leaves the list, and the account's audit log keeps its name: the revoke is recorded under your name as Account key <name> revoked. A revoked key no longer counts toward the plan's keys, so a paused key can resume.
Permission required
The members:delete permission on the active account. Anyone with it can revoke any key, whoever created it. Call it from a dashboard session or with your own API key; an account key can't revoke keys, itself included (403, account_key_not_allowed).
Path parameters
uuid string (uuid) Req
The key's
uuid from GET /v1/account/keys.Response (204 No Content)
Empty body on success.
Errors
401 Unauthorized
Missing or invalid auth.
403 Forbidden
The caller lacks
members:delete, the request uses an account key (account_key_not_allowed), or the account is suspended (account_suspended).404 Not Found
account key not found: no such key in the active account, or it is already revoked.Request
curl -X DELETE "https://api.ngris.com/v1/account/keys/019a4e2f-6c1d-7b3a-9e52-3f8d1c7a2b40" \
-H "X-API-KEY: <your_api_key>"
Revoked — 204 No Content
The revoked key, on its next request — 401 Unauthorized
Invalid API Key
Was this helpful?