Create Browser Session

post/browser-sessions

Request body

session_idstring nullable
mode'headless' | 'live'
backend'firecracker' | 'qemu' | 'libkrun' | 'auto'
profile_mode'ephemeral' | 'persistent'
profile_idstring nullable
timeout_minutesinteger
record_videoboolean
allow_downloadsboolean
memoryinteger
disk_sizeinteger

Response

Successful Response

session_idstring required
sandbox_idstring required
status'created' | 'starting' | 'ready' | 'stopping' | 'error' | 'deleted' required

Browser session lifecycle states.

cdp_urlstring required
viewer_urlstring nullable
display_urlstring nullable
profile_idstring nullable

Changes

Changed in 3 of the 9 revisions of this API.12