How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Browser Use

Browser Use Public API v2

The step-priced Browser Use Cloud REST API — tasks and task logs, sessions with public share links, presigned file upload/download URLs, browser profiles, standalone browsers, and the Skills surface that turns a website workflow into a callable deterministic endpoint, plus the skills marketplace. 44 operations, OpenAPI 3.1.

Documentation Provider Profile APIs.io OpenAPI GitHub

Browser Use Public API v2 is one of 4 APIs that Browser Use publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Browser Automation, Skills, and Marketplace. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 44 operations across 29 paths, organized into 8 resource areas, and defines 84 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://api.browser-use.com/api/v2.

44 operations 29 paths 84 schemas 4 DELETE20 GET5 PATCH15 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://api.browser-use.com/api/v2
Authentication
API Key
Resource Areas
8

Authentication & Security 1

Browser Use Public API v2 declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Browser-Use-API-Key (APIKeyHeader).

Paths & Operations 44

Across 29 paths, the API surfaces 44 operations — 4 DELETE, 20 GET, 5 PATCH, 15 POST. They span 8 resource areas: Billing, Tasks, Sessions, Files, Profiles, Browsers, Skills, Skills Marketplace. Each is listed below with its method, path, parameters, and response codes.

Billing 1
GET
/billing/account
Get Account Billing
get_account_billing_billing_account_get → 200404422
Tasks 6
GET
/tasks
List Tasks
list_tasks_tasks_get 6 params → 200422
POST
/tasks
Create Task
create_task_tasks_post body → 202400404422429
GET
/tasks/{task_id}
Get Task
get_task_tasks__task_id__get 1 param → 200404422
PATCH
/tasks/{task_id}
Update Task
update_task_tasks__task_id__patch 1 param body → 200404422
GET
/tasks/{task_id}/status
Get Task Status
get_task_status_tasks__task_id__status_get 1 param → 200404422
GET
/tasks/{task_id}/logs
Get Task Logs
get_task_logs_tasks__task_id__logs_get 1 param → 200404500422
Sessions 9
GET
/sessions
List Sessions
list_sessions_sessions_get 3 params → 200422
POST
/sessions
Create Session
create_session_sessions_post body → 201402404422429
GET
/sessions/{session_id}
Get Session
get_session_sessions__session_id__get 1 param → 200404422
PATCH
/sessions/{session_id}
Update Session
update_session_sessions__session_id__patch 1 param body → 200404422
DELETE
/sessions/{session_id}
Delete Session
delete_session_sessions__session_id__delete 1 param → 204404422
POST
/sessions/{session_id}/purge
Purge Session
purge_session_sessions__session_id__purge_post 1 param → 204403404422
GET
/sessions/{session_id}/public-share
Get Session Public Share
get_session_public_share_sessions__session_id__public_share_get 1 param → 200404422
POST
/sessions/{session_id}/public-share
Create Session Public Share
create_session_public_share_sessions__session_id__public_share_post 1 param → 201404422
DELETE
/sessions/{session_id}/public-share
Delete Session Public Share
delete_session_public_share_sessions__session_id__public_share_delete 1 param → 204404422
Files 3
POST
/files/sessions/{session_id}/presigned-url
Agent Session Upload File Presigned Url
agent_session_upload_file_presigned_url_files_sessions__session_id__presigned_url_post 1 param body → 200400404500422
POST
/files/browsers/{session_id}/presigned-url
Browser Session Upload File Presigned Url
browser_session_upload_file_presigned_url_files_browsers__session_id__presigned_url_post 1 param body → 200400404500422
GET
/files/tasks/{task_id}/output-files/{file_id}
Get Task Output File Presigned Url
get_task_output_file_presigned_url_files_tasks__task_id__output_files__file_id__get 2 params → 200404500422
Profiles 5
GET
/profiles
List Profiles
list_profiles_profiles_get 3 params → 200422
POST
/profiles
Create Profile
create_profile_profiles_post body → 201402422
GET
/profiles/{profile_id}
Get Profile
get_profile_profiles__profile_id__get 1 param → 200404422
PATCH
/profiles/{profile_id}
Update Profile
update_profile_profiles__profile_id__patch 1 param body → 200404422
DELETE
/profiles/{profile_id}
Delete Browser Profile
delete_browser_profile_profiles__profile_id__delete 1 param → 204422
Browsers 5
GET
/browsers
List Browser Sessions
list_browser_sessions_browsers_get 5 params → 200422
POST
/browsers
Create Browser Session
create_browser_session_browsers_post body → 201403404422429
GET
/browsers/{session_id}
Get Browser Session
get_browser_session_browsers__session_id__get 1 param → 200404422
PATCH
/browsers/{session_id}
Update Browser Session
update_browser_session_browsers__session_id__patch 1 param body → 200404422
GET
/browsers/{session_id}/downloads
List Browser Session Downloads
list_browser_session_downloads_browsers__session_id__downloads_get 4 params → 200404422
Skills 11
GET
/skills
List Skills
list_skills_skills_get 8 params → 200422
POST
/skills
Create Skill
create_skill_skills_post body → 202400402429422
GET
/skills/{skill_id}
Get Skill
get_skill_skills__skill_id__get 1 param → 200404422
DELETE
/skills/{skill_id}
Delete Skill
delete_skill_skills__skill_id__delete 1 param → 204400404422
PATCH
/skills/{skill_id}
Update Skill
update_skill_skills__skill_id__patch 1 param body → 200404403422
POST
/skills/{skill_id}/cancel
Cancel Generation
cancel_generation_skills__skill_id__cancel_post 1 param → 200404400422
POST
/skills/{skill_id}/rollback
Rollback Skill
rollback_skill_skills__skill_id__rollback_post 1 param → 200404400422
POST
/skills/{skill_id}/execute
Execute Skill
execute_skill_skills__skill_id__execute_post 1 param body → 200404400402429422
POST
/skills/{skill_id}/refine
Refine Skill
refine_skill_skills__skill_id__refine_post 1 param body → 202404400429422
GET
/skills/{skill_id}/executions
List Skill Executions
list_skill_executions_skills__skill_id__executions_get 3 params → 200404422
GET
/skills/{skill_id}/executions/{execution_id}/output
Get Skill Execution Output
get_skill_execution_output_skills__skill_id__executions__execution_id__output_get 2 params → 200404422
Skills Marketplace 4
GET
/marketplace/skills
List Skills
list_skills_marketplace_skills_get 6 params → 200422
GET
/marketplace/skills/{skill_slug}
Get Skill
get_skill_marketplace_skills__skill_slug__get 1 param → 200404422
POST
/marketplace/skills/{skill_id}/clone
Clone Skill
clone_skill_marketplace_skills__skill_id__clone_post 1 param → 200404400422
POST
/marketplace/skills/{skill_id}/execute
Execute Skill
execute_skill_marketplace_skills__skill_id__execute_post 1 param body → 200404400402422

Schemas 84

The contract defines 84 schemas that model the data the API accepts and returns. The most detailed are SkillResponse (23 properties), CreateTaskRequest (21 properties), TaskView (18 properties), MarketplaceSkillResponse (16 properties). Each schema is shown below with its type and property counts.

AccountNotFoundError
object
Error response when an account is not found
1 property
AccountView
object
View model for account information.
11 properties 8 required
BrowserDownloadFile
object
A single file the browser downloaded during the session.
4 properties 3 required
BrowserDownloadListResponse
object
Paginated list of browser downloads with optional presigned URLs.
3 properties 1 required
BrowserSessionItemView
object
View model for representing a browser session in list views.
13 properties 4 required
BrowserSessionListResponse
object
Response model for paginated browser session list requests.
4 properties 4 required
BrowserSessionStatus
string
Enumeration of possible browser session states Attributes: ACTIVE: Session is currently active and running (browser is running) STOPPED: Session has been stopp…
BrowserSessionUpdateAction
string
Available actions that can be performed on a browser session Attributes: STOP: Stop the browser session (cannot be undone)
BrowserSessionView
object
View model for representing a browser session.
14 properties 4 required
CannotDeleteSkillWhileGeneratingError
object
Error response when a skill cannot be deleted while it is still generating
1 property
CannotRollbackPublicSkillError
object
Error response when trying to rollback a public skill
1 property
ConcurrentSkillCreationsError
object
Error response when concurrent skill creations are attempted
1 property
CreateBrowserSessionRequest
object
Request model for creating a browser session.
9 properties
CreateSessionRequest
object
Request model for creating a session.
9 properties
CreateSkillRequest
object
Request to create a new skill via automated generation.
4 properties 2 required
CreateSkillResponse
object
Response after creating a skill.
1 property 1 required
CreateTaskRequest
object
Request model for creating a task
21 properties 1 required
CustomProxy
object
Request model for creating a custom proxy.
5 properties 2 required
DownloadUrlGenerationError
object
Error response when download URL generation fails
1 property
EnabledSkillsLimitExceededError
object
Error response when trying to enable more skills than allowed by plan
1 property
ExecuteSkillRequest
object
Request to execute a skill.
2 properties
ExecuteSkillResponse
object
Response from executing a skill.
5 properties 1 required
FileView
object
View model for representing an output file generated by the agent
2 properties 2 required
GenerationNotCancellableError
object
Error response when generation is not cancellable
1 property
HTTPValidationError
object
1 property
InsufficientCreditsError
object
Error response when there are insufficient credits
1 property
InternalServerError
object
Error response for internal server errors
1 property
MarketplaceSkillListResponse
object
Response for listing skills.
4 properties 4 required
MarketplaceSkillResponse
object
Skill information returned by the API.
16 properties 15 required
OutputFileNotFoundError
object
Error response when an output file is not found
1 property
ParameterSchema
object
Schema for a skill parameter.
6 properties 2 required
ParameterType
string
Type of a skill parameter.
PlanInfo
object
View model for plan information
5 properties 5 required
ProfileCreateRequest
object
Request model for creating a new profile.
2 properties
ProfileListResponse
object
Response model for paginated profile list requests.
4 properties 4 required
ProfileNotFoundError
object
Error response when a profile is not found
1 property
ProfileUpdateRequest
object
Request model for updating a profile.
2 properties
ProfileView
object
View model for representing a profile. A profile lets you preserve the login state between sessions. We recommend that you create a separate profile for each u…
7 properties 3 required
ProxyCountryCode
string
RefineSkillRequest
object
Request to refine an existing skill.
3 properties 1 required
RefineSkillResponse
object
Response after requesting skill refinement.
1 property 1 required
SessionHasRunningTaskError
object
Error response when session already has a running task
1 property
SessionItemView
object
View model for representing a (browser) session.
10 properties 5 required
SessionListResponse
object
Response model for paginated session list requests.
4 properties 4 required
SessionNotFoundError
object
Error response when a session is not found
1 property
SessionSettings
object
Session configuration for auto-created sessions. These settings only apply when no sessionid is provided.
5 properties
SessionStatus
string
Enumeration of possible agent session states Attributes: ACTIVE: Agent session is currently active and running STOPPED: Agent session has been stopped and is n…
SessionStoppedError
object
Error response when trying to use a stopped session
1 property
SessionTimeoutLimitExceededError
object
Error response when session timeout exceeds the maximum allowed limit
1 property
SessionUpdateAction
string
Available actions that can be performed on a session Attributes: STOP: Stop the session and all its associated tasks (cannot be undone)
SessionView
object
View model for representing a (browser) session with its associated tasks.
12 properties 4 required
ShareNotFoundError
object
Error response when a public share is not found
1 property
ShareView
object
View model for representing a public share of a session.
4 properties 3 required
SkillCategory
string
Skill category.
SkillExecutionListResponse
object
Response for listing skill executions.
4 properties 4 required
SkillExecutionOutputResponse
object
Response containing presigned URL for downloading execution output.
1 property 1 required
SkillExecutionView
object
View for a skill execution.
8 properties 8 required
SkillListResponse
object
Response for listing skills.
4 properties 4 required
SkillNotFinishedError
object
Error response when skill is not finished
1 property
SkillNotFoundError
object
Error response when a skill is not found
1 property
SkillResponse
object
Skill information returned by the API.
23 properties 13 required
SkillsGenerationStatus
string
Status of skill generation.
SupportedLLMs
string
TaskCreatedResponse
object
Response model for creating a task
2 properties 2 required
TaskItemView
object
View model for representing a task with its execution details
16 properties 6 required
TaskListResponse
object
Response model for paginated task list requests.
4 properties 4 required
TaskLogFileResponse
object
Response model for log file requests
1 property 1 required
TaskNotFoundError
object
Error response when a task is not found
1 property
TaskOutputFileResponse
object
Response model for output file requests.
3 properties 3 required
TaskStatus
string
Enumeration of possible task execution states Attributes: CREATED: Task has been created but not yet started. STARTED: Task has been started and is currently r…
TaskStatusView
object
Lightweight view optimized for polling. Use GET /tasks/{id}/status for efficient polling instead of GET /tasks/{id} which loads full step details.
6 properties 2 required
TaskStepView
object
View model for representing a single step in a task's execution
8 properties 6 required
TaskUpdateAction
string
Available actions that can be performed on a task Attributes: STOP: Stop the current task execution STOPTASKANDSESSION: Stop both the task and its parent sessi…
TaskView
object
View model for representing a task with its execution details
18 properties 8 required
ThinkingLevel
string
Provider-neutral model reasoning depth.
TooManyConcurrentActiveSessionsError
object
Error response when user has too many concurrent active sessions
1 property
UnsupportedContentTypeError
object
Error response for unsupported content types
1 property
UpdateBrowserSessionRequest
object
Request model for updating browser session state.
1 property 1 required
UpdateSessionRequest
object
Request model for updating session state.
1 property 1 required
UpdateSkillRequest
object
Request to update skill metadata.
5 properties
UpdateTaskRequest
object
Request model for updating task state
1 property 1 required
UploadFilePresignedUrlResponse
object
Response model for a presigned upload URL.
5 properties 5 required
UploadFileRequest
object
Request model for uploading a file to the user's files bucket.
3 properties 3 required
ValidationError
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

browser-use-api-v2-openapi.json Raw ↑

Other APIs Browser Use publishes across the network.

Browser Use Public API v4
AE Profile APIs.io
Browser Use Public API v3
AE Profile APIs.io
Browser Use MCP Server
AE Profile APIs.io
#Browser Automation#Skills#Marketplace
← Back to B APIs
API Details
ID
browser-use:browser-use-api-v2
Base URL
https://api.browser-use.com/api/v2
Docs
https://docs.browser-use.com/cloud/api-v2-overview
Provider
Browser Use
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=browser-use-api-v2&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/browser-use-api-v2"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Browser Use Public API v2, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.