# Hyperresearch Runs API

**Canonical:** https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-runs-api/  
**Provider:** Hyperresearch — https://apis.io/providers/hyperresearch-ai/  
**Base URL:** https://api.hyperresearch.ai  
**Documentation:** https://hyperresearch.ai/docs/api

Hyperresearch Runs API is one of 16 APIs that [Hyperresearch](https://apis.io/providers/hyperresearch-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Research runs

## Operations (39)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/runs` | Create a run |
| GET | `/v1/runs` | List runs |
| POST | `/v1/runs/{id}/clarify` | Answer a run’s clarification questions |
| GET | `/v1/runs/{id}` | Get a run |
| PATCH | `/v1/runs/{id}` | File a run under a project (or unfile it) |
| GET | `/v1/runs/{id}/result` | Get a run result |
| GET | `/v1/runs/{id}/artifacts/{name}` | Re-sign one artifact |
| GET | `/v1/artifacts/download` | Redeem a signed artifact download URL |
| POST | `/v1/runs/{id}/pause` | Pause a run |
| POST | `/v1/runs/{id}/resume` | Resume a run |
| POST | `/v1/runs/{id}/abort` | Abort a run |
| POST | `/v1/runs/{id}/rerun-from` | Re-enter a run at a step |
| POST | `/v1/runs/{id}/resume-finish` | Re-run the final step of a run that stopped on it |
| GET | `/v1/runs/{id}/events` | Stream run events (SSE) |
| POST | `/v1/assess` | Check a question before running it (Sharpen) |
| POST | `/v1/assess/flow` | One step of the console’s question flow |
| GET | `/v1/runs/{id}/result.pdf` | Download a run result as a styled PDF |
| GET | `/v1/runs/{id}/reader` | Get a run as a reader view |
| GET | `/v1/runs/{id}/sources/{n}/saved` | Read the saved copy of a source |
| GET | `/v1/runs/{id}/export/saved` | Read a page of a run’s saved copies, for a download |
| POST | `/v1/runs/{id}/ask` | Ask a question of a finished report |
| POST | `/v1/runs/{id}/ask/web` | Search the web for a question the report does not answer |
| POST | `/v1/runs/{id}/share` | Create or replace a run’s share link |
| DELETE | `/v1/runs/{id}/share` | Revoke a run’s share link |
| GET | `/v1/shared/{token}` | Read a shared report |
| GET | `/v1/shared/{token}/export` | Read a shared report for a download |
| POST | `/v1/shared/{token}/unlock` | Unlock a password-protected shared report |
| POST | `/v1/shared/{token}/ask` | Ask a question of a shared report |
| GET | `/v1/runs/{id}/feedback` | Read your rating of a report |
| PATCH | `/v1/runs/{id}/feedback` | Save part of your rating of a report |
| GET | `/v1/runs/{id}/community` | Read the community panel of your run |
| POST | `/v1/admin/backfills/run-counters` | Repair legacy run counters from the vault |
| GET | `/v1/admin/runs/{id}/events` | One run's own event log, whatever workspace it is in |
| GET | `/v1/admin/runs/{id}` | One run, from all three records, with its diagnostic counts |
| GET | `/v1/admin/runs/{id}/cost` | What one run cost us, by model and by paid provider, beside its price |
| POST | `/v1/admin/runs/{id}/flags` | Hide or show one finished run's flagged claims |
| GET | `/v1/admin/runs` | Find a run across every workspace |
| POST | `/v1/admin/runs/{id}/platform-rerun` | Start a customer run's free platform rerun |
| POST | `/v1/refine-drafts/{id}/claim` | Claim a homepage draft after sign-up |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hyperresearch-ai/openapi/hyperresearch-ai-runs-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-run-status-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-usage-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-run-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-run-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-answer-search-body-schema.json
- **JSONSchema** — https://artifacts.apis.io/hyperresearch-ai/json-schema/hyperresearch-ai-operator-run-detail-schema.json

## Other Hyperresearch APIs (12)

- [Hyperresearch Account API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-account-api/)
- [Hyperresearch agent connections API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-agent-connections-api/)
- [Hyperresearch Answers API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-answers-api/)
- [Hyperresearch Auth API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-auth-api/)
- [Hyperresearch Billing API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-billing-api/)
- [Hyperresearch Demo API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-demo-api/)
- [Hyperresearch Keys API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-keys-api/)
- [Hyperresearch Meta API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-meta-api/)
- [Hyperresearch Projects API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-projects-api/)
- [Hyperresearch Scholar API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-scholar-api/)
- [Hyperresearch Usage API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-usage-api/)
- [Hyperresearch Vault API](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-vault-api/)

## Tags

Runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hyperresearch-ai/hyperresearch-ai-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hyperresearch-ai/.