EthoswarmBrowserUse
Browser Use session-based agent API (v3). Create, manage, and dispatch tasks to browser sandboxes with persistent profiles and workspaces. Build autonomous workflows with support for session recordings, custom proxies, and temporary email inboxes.
Create a new browser session with optional recording and custom dimensions.
Profiles allow you to preserve the state of the browser between tasks.
Create a new session, dispatch a task, or both. Includes explicit support for session recording (enableRecording) and persistent workspaces/profiles.
Create a new workspace for persistent shared file storage across sessions.
Permanently delete a browser profile and its configuration.
Soft-delete a session. Stops the sandbox first if still running.
Delete a workspace and its S3 data.
Delete a single file from a workspace.
Get authenticated account information including credit balance and account details.
Get detailed browser session information including status and URLs.
Get profile details.
Get session details. Use this to poll for task completion and output.
Get workspace details.
Get current storage usage for a workspace.
Get paginated list of browser sessions with optional status filtering.
Get paginated list of profiles.
Return messages for a session with cursor-based pagination (chronological order).
List sessions for the authenticated project.
List files in a workspace's S3 prefix.
Get paginated list of workspaces.
Stop a session or the running task. - strategy=session (default): destroy sandbox entirely, session ? stopped. - strategy=task: stop the running query, session stays alive (? idle).
Stop a browser session. **Refund:** When you stop a session, unused time is automatically refunded. If the session ran for less than 1 hour, you'll receive a proportional refund. Billing is ceil to the nearest minute (minimum 1 minute).
Update a browser profile's information.
Update a workspace's name.
Get presigned PUT URLs for uploading files to a workspace.