long form
packaging

Keep or reject a find

Record keep or reject on one find; the last verdict wins. The verdict is the video's on that tab: every find of the same video you have there (an earlier run's, a later one's) carries it. Kept videos come back from GET /v1/finds/keeps. Free. MCP: keep_find.

post/v1/finds/{find_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/finds/{find_id}/decision
  • Auth: none declared

Path parameters

find_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

find_idstring required
verdictstring nullable required

keep, reject, or null once cleared

Example response

{
  "find_id": "7c8d9e0f-1a2b-4c3d-8e4f-5a6b7c8d9e0f",
  "verdict": "keep"
}

Changes

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