Create Browser Session - AgentEnv

API
Request Body
Responses
CLI
Python SDK

Create a remote browser session with screen, proxy, rrweb, and profile options.

API

Operation: POST /browser/sessions OpenAPI Source: api-reference/openapi.json

Request Body

Field	Type	Required
name	string	yes
workspaceId	string	no
screenWidth	number	no
screenHeight	number	no
enableStealth	boolean	no
enableAdblock	boolean	no
profileMode	string	no
proxyUrl	string	no
proxyUsername	string	no
proxyPassword	string	no
proxyProvider	string	no
proxyType	string	no
enableCaptchaSolver	boolean	no
captchaProvider	string	no
captchaApiKey	string	no
enableRrweb	boolean	no
enableLogger	boolean	no
cpuMillis	number	no
memoryMb	number	no
maxLifetimeSeconds	number	no
gpuType	string	no
profileId	string	no
geonodeProxy	object	no

Responses

Status	Description
201	Browser session created successfully
400	Bad request
401	Unauthorized

CLI

Supported via CLI.

agv browser create --screen-width 1920 --screen-height 1080 --stealth

Notes:

The browser CLI also supports profile, proxy, captcha, rrweb, and open/wait controls.

Python SDK

Supported via Python SDK.

client.browser.create(screen_width=1920, screen_height=1080, stealth=True)

Notes:

Use Client.browser.create() for programmatic session creation.