# Browser Use

## Docs

- [Introduction](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/agent/quickstart.md): Easiest way to automate the web. Tell this agent in natural language what it should do, and it can interact with the web like a human.
- [Agent (v2)](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/legacy/agent.md): V2 agent models and file handling.
- [Public share links (v2)](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/legacy/public-share.md): Generate shareable URLs for agent sessions using the v2 API.
- [List Sessions](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/sessions/list-sessions.md): List sessions for the authenticated project.
- [Create Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/sessions/create-session.md): Create a session and/or dispatch a task.
- [Get Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/sessions/get-session.md): Get session details. Use this to poll for task completion and output.
- [Delete Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/sessions/delete-session.md): Soft-delete a session. Stops the sandbox first if still running.
- [Stop Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/sessions/stop-session.md): Stop a session or the running task.
- [List Session Messages](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/sessions/list-session-messages.md): Return messages for a session with cursor-based pagination (chronological order).
- [List Browser Sessions](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/browsers/list-browser-sessions.md): Get paginated list of browser sessions with optional status filtering.
- [Create Browser Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/browsers/create-browser-session.md): Create a new browser session.
- [Get Browser Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/browsers/get-browser-session.md): Get detailed browser session information including status and URLs.
- [Update Browser Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/browsers/update-browser-session.md): Stop a browser session.
- [List Profiles](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/profiles/list-profiles.md): Get paginated list of profiles.
- [Create Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/profiles/create-profile.md): Profiles allow you to preserve the state of the browser between tasks.
- [Get Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/profiles/get-profile.md): Get profile details.
- [Delete Browser Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/profiles/delete-browser-profile.md): Permanently delete a browser profile and its configuration.
- [Update Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/profiles/update-profile.md): Update a browser profile's information.
- [List Workspaces](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/list-workspaces.md): Get paginated list of workspaces.
- [Create Workspace](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/create-workspace.md): Create a new workspace for persistent shared file storage across sessions.
- [Get Workspace](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/get-workspace.md): Get workspace details.
- [Delete Workspace](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/delete-workspace.md): Delete a workspace and its S3 data.
- [Update Workspace](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/update-workspace.md): Update a workspace's name.
- [List Workspace Files](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/list-workspace-files.md): List files in a workspace's S3 prefix.
- [Delete Workspace File](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/delete-workspace-file.md): Delete a single file from a workspace.
- [Get Workspace Size](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/get-workspace-size.md): Get current storage usage for a workspace.
- [Upload Workspace Files](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/workspaces/upload-workspace-files.md): Get presigned PUT URLs for uploading files to a workspace.
- [List Session Files](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/files/list-session-files.md): List files in a session's workspace.
- [Upload Session Files](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/files/upload-session-files.md): Get presigned PUT URLs for uploading files to a session's workspace.
- [Get Account Billing](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v3/billing/get-account-billing.md): Get authenticated account information including credit balance and account details.
- [Get Account Billing](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/billing/get-account-billing.md): Get authenticated account information including credit balance and account details.
- [List Tasks](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/tasks/list-tasks.md): Get paginated list of AI agent tasks with optional filtering by session and status.
- [Create Task](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/tasks/create-task.md): Create and start a new task.
- [Get Task](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/tasks/get-task.md): Get detailed task information including status, progress, steps, and file outputs.
- [Update Task](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/tasks/update-task.md): Control task execution with stop, pause, resume, or stop task and session actions.
- [Get Task Status](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/tasks/get-task-status.md): Lightweight endpoint optimized for polling task status.
- [Get Task Logs](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/tasks/get-task-logs.md): Get secure download URL for task execution logs with step-by-step details.
- [List Sessions](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/list-sessions.md): Get paginated list of AI agent sessions with optional status filtering.
- [Create Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/create-session.md): Create a new session with a new task.
- [Get Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/get-session.md): Get detailed session information including status, URLs, and task details.
- [Delete Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/delete-session.md): Delete a session with all its tasks.
- [Update Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/update-session.md): Stop a session and all its running tasks.
- [Purge Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/purge-session.md): Immediately purge all data for a session (ZDR projects only).
- [Get Session Public Share](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/get-session-public-share.md): Get public share information including URL and usage statistics.
- [Create Session Public Share](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/create-session-public-share.md): Create or return existing public share for a session.
- [Delete Session Public Share](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/sessions/delete-session-public-share.md): Remove public share for a session.
- [Agent Session Upload File Presigned Url](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/files/agent-session-upload-file-presigned-url.md): Generate a secure presigned URL for uploading files to an agent session.
- [Browser Session Upload File Presigned Url](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/files/browser-session-upload-file-presigned-url.md): Generate a secure presigned URL for uploading files to a browser session.
- [Get Task Output File Presigned Url](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/files/get-task-output-file-presigned-url.md): Get secure download URL for an output file generated by the AI agent.
- [List Profiles](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/profiles/list-profiles.md): Get paginated list of profiles.
- [Create Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/profiles/create-profile.md): Profiles allow you to preserve the state of the browser between tasks.
- [Get Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/profiles/get-profile.md): Get profile details.
- [Delete Browser Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/profiles/delete-browser-profile.md): Permanently delete a browser profile and its configuration.
- [Update Profile](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/profiles/update-profile.md): Update a browser profile's information.
- [List Browser Sessions](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/browsers/list-browser-sessions.md): Get paginated list of browser sessions with optional status filtering.
- [Create Browser Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/browsers/create-browser-session.md): Create a new browser session.
- [Get Browser Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/browsers/get-browser-session.md): Get detailed browser session information including status and URLs.
- [Update Browser Session](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/browsers/update-browser-session.md): Stop a browser session.
- [List Skills](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/list-skills.md): List all skills owned by the authenticated project with optional filtering.
- [Create Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/create-skill.md): Create a new skill via automated generation.
- [Get Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/get-skill.md): Get details of a specific skill owned by the project.
- [Delete Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/delete-skill.md): Delete a skill owned by the project.
- [Update Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/update-skill.md): Update skill metadata (name, description, enabled, etc.).
- [Cancel Generation](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/cancel-generation.md): Cancel the current in-progress generation for a skill.
- [Rollback Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/rollback-skill.md): Rollback to the previous version (cannot be undone).
- [Execute Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/execute-skill.md): Execute a skill with the provided parameters.
- [Refine Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/refine-skill.md): Refine a skill based on feedback.
- [List Skill Executions](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/list-skill-executions.md): List executions for a specific skill.
- [Get Skill Execution Output](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills/get-skill-execution-output.md): Get presigned URL for downloading skill execution output.
- [List Skills](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills-marketplace/list-skills.md): List all public skills available in the marketplace with optional filtering.
- [Get Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills-marketplace/get-skill.md): Get details of a specific public skill from the marketplace.
- [Clone Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills-marketplace/clone-skill.md): Clone a public marketplace skill to the user's project.
- [Execute Skill](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/cloud/api-v2/skills-marketplace/execute-skill.md): Execute a skill with the provided parameters.
- [Browser Use CLI](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/open-source/browser-use-cli.md): Fast, persistent browser automation from the command line.

## OpenAPI Specs

- [v3](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/openapi/v3.json)
- [v2](https://browseruse-0aece648-magnus-citrine-function.mintlify.site/openapi/v2.json)