hooks

Keep or reject a hook

Record keep or reject on one hook; the last verdict wins. Kept hooks come back from GET /v1/keeps across every run. Free. MCP: keep_hook.

post/v1/hooks/{hook_id}/decision

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/hooks/{hook_id}/decision
  • Auth: none declared

Path parameters

hook_idstring uuid required

Headers

authorizationstring nullable

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

Request body

verdictstring required
reason'off_subject' | 'weak_opening' | 'wrong_language' | 'low_quality' | 'already_have' | 'other' nullable

with verdict "reject" only, optional: why it was passed

notestring nullable

with a reason, optional: the reason in your own words

Example request

{
  "verdict": "keep",
  "reason": "off_subject"
}

Response

Successful Response

hook_idstring required
verdictstring required

Example response

{
  "hook_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "verdict": "keep"
}

Changes

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