admin

Every access code, never the code itself. Owner only.

Every access code, newest first (at most 500): code_id, code_prefix (the first 7 characters), email (when bound), note, source (owner, request, proof), max_uses, uses, expires_at, revoked_at, created_at and usable. The full code is never shown again after it was made. Needs the admin scope and an admin account. MCP: list_access_codes.

get/v1/admin/codes

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
  • Auth: none declared

Headers

authorizationstring nullable

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

Response

Successful Response

Example response

{
  "codes": [
    {
      "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",
      "source": "owner",
      "usable": true,
      "uses": 1
    }
  ]
}

Changes

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