Session lifecycle
Create, poll status, connect, monitor runtime, and terminate remote browsers through dashboard API endpoints.
Remote-browserCLOUD BROWSER API
Create a cloud browser session from an API call.
Remote Browser exposes hosted Chromium as an API: create a session, connect over CDP, watch it live, reuse profile state, and terminate it when your job completes.
POSTcreate session
GETstatus polling
WSSCDP connect
Connection artifacts
Each running browser can expose a CDP URL for automation and a viewer URL for human inspection.
Runtime options
Configure resolution, idle timeout, region, profile, recording retention, proxy, and launch arguments at creation time.
Workflow
From browser creation to evidence.
Create
POST a browser request with API-key auth and the runtime options your workflow needs.
Connect
Poll status until running, then attach Playwright, Puppeteer, browser-use, or an agent to the CDP URL.
Terminate
Close the browser explicitly or let idle timeout stop inactive sessions to control browser-hour spend.
FAQ
Short answers for searchers and AI crawlers.
Is the API only for the dashboard?
No. API keys can create and manage browser sessions from integrations, scripts, and agent runtimes.
Can I create a browser with a profile?
Yes. The API supports profile IDs or names so a session can reuse prepared browser state.
Can I record API-created sessions?
Yes. Set recording options at creation time, within the retention limits of the current plan.