keys

Revoke a key ("original", a key_id, or "others" for all but yours)

Revoke one key at once. You may revoke the key you are calling with, whatever its scopes (the response says so in current); revoking another needs admin. Never the last usable key (409 last_active_key: create another first). An unknown or already revoked key is 404 key_not_found. key_id "others" revokes every key of the account except the one calling, for a key that leaked, and answers revoked_count and kept. MCP: revoke_key.

delete/v1/keys/{key_id}

Request

  • Base URL: https://api.hookdetector.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.hookdetector.com/v1/keys/{key_id}
  • Auth: none declared

Path parameters

key_idstring required

Headers

authorizationstring nullable

Bearer hd_... from POST /v1/accounts or POST /v1/keys

Response

Successful Response

key_idstring required
revokedboolean required
revoked_atstring required
currentboolean required
messagestring required

Example response

{
  "current": false,
  "key_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "message": "Revoked. Calls with this key are refused from now on.",
  "revoked": true,
  "revoked_at": "2026-09-23T10:00:00.000000+00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.