runs

List runs

Runs in this workspace, newest first. project_id=proj_… narrows to one project and project_id=none to unfiled runs. Combine with status=done for that project’s reports, or ask for several statuses at once — status=done,failed,aborted,blocked is one request for "finished, plus everything that ended without a report". A row carries its own counters, failure_reason and project_id, so a list screen needs no GET /v1/runs/{id} per row.

get/v1/runs

Request

  • Base URL: https://api.hyperresearch.ai
  • URL: https://api.hyperresearch.ai/v1/runs
  • Auth: one of:
    • HTTP bearer
    • API key in cookie hr_session

Query parameters

statusstring

One status, or several comma-separated: queued|running|paused|blocked|done|failed|aborted. status=done,failed,aborted,blocked is one request for "finished, plus everything that ended without a report".

Example:done
project_idstring

A proj_… id returns only that project’s runs; the literal none returns only unfiled runs. Omit for every run in the workspace.

tier'light' | 'brief' | 'full' | 'premier' | 'dissertation'
sincestring
cursorstring
limitinteger

Response

Runs

has_moreboolean required
next_cursorstring nullable required

Changes

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