admin

Revoke an access code. Owner only.

The code admits nobody from now on. Accounts it already created keep working. Revoking a revoked code answers the same. 404 access_code_not_found for an unknown id. Needs the admin scope and an admin account. MCP: revoke_access_code.

delete/v1/admin/codes/{code_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/admin/codes/{code_id}
  • Auth: none declared

Path parameters

code_idstring required

Headers

authorizationstring nullable

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

Response

Successful Response

code_idstring required
code_prefixstring required

the first 7 characters, to tell codes apart

emailstring nullable required
notestring nullable required
source'owner' | 'request' | 'proof' | 'other' required
max_usesinteger required
usesinteger required
expires_atstring nullable required
revoked_atstring nullable required
created_atstring required
usableboolean required

not revoked, not expired, not used up

revokedboolean required

Example response

{
  "code_id": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f",
  "code_prefix": "HD-7K3M",
  "created_at": "2026-09-23T10:00:00.000000+00:00",
  "max_uses": 5,
  "note": "for the podcast crew",
  "revoked": true,
  "revoked_at": "2026-09-23T10:00:00.000000+00:00",
  "source": "owner",
  "usable": false,
  "uses": 1
}

Changes

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