admin

Approve a request: make a one-use code and email it. Owner only.

Make a one-use access code for the request, mark it approved and email the code to the person. The code is in this response once, with emailed true or false: when the email did not go out, send the code yourself or approve again, which revokes the unused code and sends a new one. A request whose code was already used is 409 request_already_decided. Needs the admin scope and an admin account. MCP: approve_access_request.

post/v1/admin/requests/{request_id}/approve

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/requests/{request_id}/approve
  • Auth: none declared

Path parameters

request_idstring required

Headers

authorizationstring nullable

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

Response

Successful Response

request_idstring required
emailstring required
status'approved' required
decided_atstring required
code_idstring required
code_prefixstring required
codestring required

the one-use code, shown here once and never again

emailedboolean required

false: the email did not go out; send the code yourself, or approve again for a new one

messagestring required

Example response

{
  "code": "HD-7K3M-Q9TX",
  "code_id": "3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f",
  "code_prefix": "HD-7K3M",
  "decided_at": "2026-09-23T10:00:00.000000+00:00",
  "email": "you@example.com",
  "emailed": true,
  "message": "Approved. The code was emailed to you@example.com.",
  "request_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "status": "approved"
}

Changes

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