---
title: "Revoke one of your API keys"
method: POST
path: "/management-console/account/api-keys/{id}/revoke"
tags: ["Your account"]
---

# Revoke one of your API keys

`POST /management-console/account/api-keys/{id}/revoke`

## Request

- Base URL: `https://verifiedhandles.org`
- URL: `https://verifiedhandles.org/management-console/account/api-keys/{id}/revoke`
- Auth: HTTP bearer

Revokes the key at once, audited: anything using it stops working. Revoking the key that makes the request is allowed, and is its last request. Back to the API keys page, `done=revoked`, or `err=gone` when it was not one of your live keys. A connected app is disconnected the same way, with its `key`: its tokens stop working at once (with `kind=app`, the page answers `done=disconnected` or `err=app_gone`).

## Path parameters

- `id` string, required

## Other responses

- `302`: No key was sent: the console sends a browser to sign in. A script should send its key.
- `303`: Done: back to /management-console/account/api-keys, `done=revoked` or `err=gone`.
- `400`: The request sent a key and a session cookie together (`bearer_with_cookie`): send one.
- `401`: The key was refused: unknown, revoked or expired, its holder may no longer use keys, or this instance takes none. Carries `WWW-Authenticate: Bearer`.
- `403`: The key’s account lacks the capability, or is blocked: the body is the word `Forbidden`. A read-only key that tries to change something is refused first, as JSON: `{"error":"read_only_key"}`.
- `429`: Too many changes in the last minute: counted per IP address, per account and per key (an admin key’s per key alone, at the limit set on Console → Rate limits). Wait the number of seconds `Retry-After` gives.
- `503`: The site is down for maintenance. The body is the maintenance page, as HTML. Try again later: `Retry-After` gives the seconds.

---

[API](https://skmtc.dev/verifiedhandles/apis/verified-handles-api.md) · [All operations](https://skmtc.dev/verifiedhandles/apis/verified-handles-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verifiedhandles/apis/verified-handles-api/revisions/40720de2e0ec?raw)