# Happyrobot Runs API

**Canonical:** https://apis.io/apis/happyrobot/happyrobot-runs-api/  
**Provider:** Happyrobot — https://apis.io/providers/happyrobot/  
**Base URL:** https://platform.happyrobot.ai/api/v2  
**Documentation:** https://docs.happyrobot.ai/api-reference

Happyrobot Runs API is one of 36 APIs that [Happyrobot](https://apis.io/providers/happyrobot/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

The Runs API from Happyrobot — 12 operation(s) for runs.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/use-cases/{use_case_id}/runs` | DEPRECATED: Get runs |
| GET | `/runs` | Get runs |
| GET | `/runs/{run_id}` | Get a run by ID |
| GET | `/runs/{run_id}/recordings` | Get a run's recordings |
| GET | `/runs/` | [Legacy] List runs |
| POST | `/runs/{run_id}/cancel` | Cancel a run |
| GET | `/runs/{run_id}/sessions` | List run sessions |
| GET | `/runs/{run_id}/nodes` | List run nodes |
| GET | `/runs/{run_id}/outputs/{output_id}` | Get run output |
| POST | `/runs/{run_id}/mark` | Mark run annotation |
| GET | `/runs/{run_id}/flags` | List run flags |
| GET | `/runs/{run_id}/audits` | List audit remarks for a run |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/openapi/happyrobot-runs-api-openapi.yml
- **Documentation** — https://docs.happyrobot.ai/api-reference
- **APIReference** — https://docs.happyrobot.ai/api-reference
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/authentication/happyrobot-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/conventions/happyrobot-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/errors/happyrobot-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/data-model/happyrobot-data-model.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/asyncapi/happyrobot-events.yml
- **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/agentic-access/happyrobot-agentic-access.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/happyrobot/refs/heads/main/lifecycle/happyrobot-lifecycle.yml

## Other Happyrobot APIs (12)

- [Happyrobot Workflows MCP Server](https://apis.io/apis/happyrobot/happyrobot-workflows-mcp-server/)
- [Happyrobot Twin MCP Server](https://apis.io/apis/happyrobot/happyrobot-twin-mcp-server/)
- [Happyrobot Docs MCP Server](https://apis.io/apis/happyrobot/happyrobot-docs-mcp-server/)
- [Happyrobot Adversarial Suites API](https://apis.io/apis/happyrobot/happyrobot-adversarial-suites-api/)
- [Happyrobot Adversarial Tests API](https://apis.io/apis/happyrobot/happyrobot-adversarial-tests-api/)
- [Happyrobot API Keys API](https://apis.io/apis/happyrobot/happyrobot-api-keys-api/)
- [Happyrobot Apps API](https://apis.io/apis/happyrobot/happyrobot-apps-api/)
- [Happyrobot Artifacts API](https://apis.io/apis/happyrobot/happyrobot-artifacts-api/)
- [Happyrobot Audits API](https://apis.io/apis/happyrobot/happyrobot-audits-api/)
- [Happyrobot Billing API](https://apis.io/apis/happyrobot/happyrobot-billing-api/)
- [Happyrobot Chat API](https://apis.io/apis/happyrobot/happyrobot-chat-api/)
- [Happyrobot Contacts API](https://apis.io/apis/happyrobot/happyrobot-contacts-api/)

## Tags

Runs

---

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