# unbrowse-ai Runs API

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

unbrowse-ai Runs API is one of 14 APIs that [unbrowse-ai](https://apis.io/providers/unbrowse-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.

Do a task on a website: start, follow, answer what it needs, cancel.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/runs` | Run a task or a capability |
| GET | `/api/v1/runs/{runId}` | Inspect a run |
| GET | `/api/v1/runs/{runId}/events` | A run's event log |
| POST | `/api/v1/runs/{runId}/responses` | Answer what a run needs |
| POST | `/api/v1/runs/{runId}/cancel` | Cancel a run |
| POST | `/api/v1/browse-local` | Start a browser session that runs on the user's own machine |
| POST | `/api/v1/browse-local/{sessionId}/op` | Issue one browse op (agent side) |
| GET | `/api/v1/browse-local/{sessionId}/next` | CLI: the next op to run (long-poll) |
| POST | `/api/v1/browse-local/{sessionId}/result` | CLI: the result of the op it ran |
| DELETE | `/api/v1/browse-local/{sessionId}` | Close a local-browse session |
| GET | `/api/v1/egress/{egressId}` | What a client-egress run is waiting for |
| POST | `/api/v1/egress/{egressId}` | Post the site's response to a request you sent |
| DELETE | `/api/v1/egress/{egressId}` | Abandon a client-egress run |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/unbrowse-ai/openapi/unbrowse-ai-runs-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/unbrowse-ai/json-schema/unbrowse-ai-run-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/unbrowse-ai/json-schema/unbrowse-ai-tool-scope-schema.json
- **JSONSchema** — https://artifacts.apis.io/unbrowse-ai/json-schema/unbrowse-ai-sharing-schema.json
- **JSONSchema** — https://artifacts.apis.io/unbrowse-ai/json-schema/unbrowse-ai-session-reuse-schema.json
- **JSONSchema** — https://artifacts.apis.io/unbrowse-ai/json-schema/unbrowse-ai-egress-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/unbrowse-ai/json-schema/unbrowse-ai-run-schema.json

## Other unbrowse-ai APIs (12)

- [unbrowse-ai Account API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-account-api/)
- [unbrowse-ai Apps & tools API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-apps-tools-api/)
- [unbrowse-ai Capabilities API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-capabilities-api/)
- [unbrowse-ai Connected apps API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-connected-apps-api/)
- [unbrowse-ai Indexing API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-indexing-api/)
- [unbrowse-ai Learning API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-learning-api/)
- [unbrowse-ai Logins & vault API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-logins-vault-api/)
- [unbrowse-ai Marketplace API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-marketplace-api/)
- [unbrowse-ai Orgs API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-orgs-api/)
- [unbrowse-ai Pages API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-pages-api/)
- [unbrowse-ai Replays API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-replays-api/)
- [unbrowse-ai Saved queries API](https://apis.io/apis/unbrowse-ai/unbrowse-ai-saved-queries-api/)

## Tags

Runs

---

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