---
title: "Find a run across every workspace"
method: GET
path: "/v1/admin/runs"
tags: ["runs"]
---

# Find a run across every workspace

`GET /v1/admin/runs`

## Request

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

Newest first, filtered by status, creation time and — optionally — workspace. The one list on this API that is not scoped to the caller's workspace, so that "which runs failed in the last hour, anywhere" is a question an operator can ask without a key per tenant. No customer query text is returned: the runs table does not store one, only `query_hash`, and that is not selected. Audited, read only.

## Query parameters

- `status` string: Exact run status, e.g. `failed`.
- `since` string, date-time: ISO timestamp; runs created at or after it.
- `workspace` string: Narrow to one workspace id. Omitted means EVERY workspace, which is deliberate: the tenant that a broken run belongs to is often the thing being looked up.
- `limit` integer: 1–200 (default 25).

## Response `200`

Matching runs

- OperatorRunSearch
  - `count` integer, required
  - `filter` object, required
    - `status` string, nullable, required
    - `since` string, nullable, required
    - `workspace_id` string, nullable, required
    - `limit` integer, required
  - `data` OperatorRunRow[], required
    - `id` string, required
    - `workspace_id` string, required
    - `status` string, required
    - `tier` string, required
    - `profile` string, required
    - `channel` string, required
    - `created_at` string, required
    - `started_at` string, nullable, required
    - `finished_at` string, nullable, required
    - `progress_at` string, nullable, required
    - `duration_ms` integer, nullable, required
    - `step_id` string, nullable, required
    - `step_name` string, nullable, required
    - `steps_done` integer, nullable, required
    - `steps_total` integer, nullable, required
    - `chapters_total` integer, nullable, required
    - `blocked_on` string, nullable, required
    - `failure_reason` string, nullable, required
    - `failure_detail` string, nullable, required: The raw platform/vendor text behind the failure. Operator surface: this is exactly the field the customer-facing run view replaces with a sentence from the failure-reason table.
    - `failure_request_id` string, nullable, required
    - `sources_fetched` integer, nullable, required
    - `notes_written` integer, nullable, required
    - `candidates_seen` integer, nullable, required
    - `fetch_attempts` integer, nullable, required
    - `report_words` integer, nullable, required
    - `price_cents` integer, nullable, required
    - `billed` integer, nullable, required
    - `launch_state` string, nullable, required
    - `launch_attempts` integer, nullable, required
    - `project_id` string, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Authentication failed
- `403`: Insufficient scope or plan
- `404`: Not found
- `429`: Rate limited or over quota
- `500`: Internal error

---

[API](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api.md) · [All operations](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/revisions/726ef831ebf4?raw)