admin

Every account's runs, newest first. Owner only.

Research runs across every account, newest first: run_id, account_id, the person's email, kind, topic, language, country, status, requested, hooks (results delivered: hooks for a short run, videos for a long or packaging run), reserved, charged, failure_kind, error, created_at and finished_at. Needs the admin scope and an admin account. MCP: admin_list_runs.

get/v1/admin/runs

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

Query parameters

limitinteger nullable

page size, 1 to 200 (default 50)

status'queued' | 'running' | 'done' | 'failed' nullable

only runs with this status

account_idstring nullable

only this account's

Headers

authorizationstring nullable

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

Response

Successful Response

Example response

{
  "runs": [
    {
      "account_id": "8f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
      "charged": 63,
      "created_at": "2026-09-23T10:00:00.000000+00:00",
      "email": "ana@example.com",
      "finished_at": "2026-09-23T10:00:00.000000+00:00",
      "hooks": 10,
      "requested": 10,
      "reserved": 200,
      "run_id": "8f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
      "status": "done",
      "topic": "cold plunge recovery"
    }
  ]
}

Changes

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