# Browser Use Public API v4

**Canonical:** https://apis.io/apis/browser-use/browser-use-api-v4/  
**Provider:** Browser Use — https://apis.io/providers/browser-use/  
**Base URL:** https://api.browser-use.com/api/v4  
**Documentation:** https://docs.browser-use.com/cloud/api-v4-overview

Browser Use Public API v4 is one of 4 APIs that [Browser Use](https://apis.io/providers/browser-use/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Web Agents, Browser Automation, and Cloud Browsers. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

The current Browser Use Cloud REST API for long-horizon agent runs — create and monitor runs, continue conversations in sessions with a message queue, persist files in workspaces, launch and stop stealth cloud browsers, and manage authenticated browser profiles. 32 operations, OpenAPI 3.1, API-key auth via the X-Browser-Use-API-Key header.

## Operations (32)

| Method | Path | Summary |
|---|---|---|
| POST | `/runs` | Create Run |
| GET | `/runs` | List Runs |
| GET | `/runs/{run_id}/attachments` | List Run Attachments |
| GET | `/runs/{run_id}` | Get Run |
| GET | `/runs/{run_id}/status` | Get Run Status |
| POST | `/runs/{run_id}/cancel` | Cancel Run |
| GET | `/runs/{run_id}/events` | Get Run Events |
| GET | `/sessions` | List Sessions |
| POST | `/sessions/{session_id}/purge` | Purge Session |
| GET | `/sessions/{session_id}` | Get Session |
| POST | `/sessions/{session_id}/queue` | Queue Session Message |
| GET | `/sessions/{session_id}/queue` | List Session Queue |
| GET | `/sessions/{session_id}/queue/{message_id}` | Get Session Queue Message |
| DELETE | `/sessions/{session_id}/queue/{message_id}` | Cancel Queued Message |
| POST | `/workspaces` | Create Workspace |
| POST | `/workspaces/{workspace_id}/files/upload` | Upload Workspace Files |
| GET | `/workspaces/{workspace_id}` | Get Workspace |
| PATCH | `/workspaces/{workspace_id}` | Update Workspace |
| DELETE | `/workspaces/{workspace_id}` | Delete Workspace |
| GET | `/workspaces/{workspace_id}/size` | Get Workspace Size |
| GET | `/workspaces/{workspace_id}/files` | List Workspace Files |
| DELETE | `/workspaces/{workspace_id}/files` | Delete Workspace File |
| GET | `/browsers` | List Browser Sessions |
| POST | `/browsers` | Create Browser Session |
| GET | `/browsers/{session_id}` | Get Browser Session |
| PATCH | `/browsers/{session_id}` | Update Browser Session |
| GET | `/browsers/{session_id}/downloads` | List Browser Session Downloads |
| GET | `/profiles` | List Profiles |
| POST | `/profiles` | Create Profile |
| GET | `/profiles/{profile_id}` | Get Profile |
| PATCH | `/profiles/{profile_id}` | Update Profile |
| DELETE | `/profiles/{profile_id}` | Delete Browser Profile |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/browser-use/refs/heads/main/openapi/browser-use-api-v4-openapi.json
- **APIReference** — https://browser-use.com/api
- **Documentation** — https://docs.browser-use.com/cloud/api-v4-overview
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/browser-use/refs/heads/main/overlays/browser-use-api-v4-overlay.yaml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/browser-use/refs/heads/main/data-model/browser-use-data-model.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/browser-use/refs/heads/main/apis.yml

## Other Browser Use APIs (3)

- [Browser Use Public API v3](https://apis.io/apis/browser-use/browser-use-api-v3/)
- [Browser Use Public API v2](https://apis.io/apis/browser-use/browser-use-api-v2/)
- [Browser Use MCP Server](https://apis.io/apis/browser-use/browser-use-mcp/)

## Tags

Web Agents, Browser Automation, Cloud Browsers

---

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