Update a running browser session — change or remove its proxy, load a profile, resize the viewport, or toggle telemetry.
Flag
Description
--proxy-id <id>
Set the proxy for the session.
--clear-proxy
Remove the proxy from the session.
--profile-id <id>
Load a profile by ID (only into a session without one).
--profile-name <name>
Load a profile by name (mutually exclusive with --profile-id).
--save-changes
Save changes back to the profile when the session ends.
--viewport <WxH@fps>
Set viewport size (e.g. 1920x1080@25).
--force
Force a viewport resize even during an active live view or recording.
--telemetry <spec>
Update telemetry: all resets to the default set, off disables, or a comma-separated list like console,network to merge those categories into the current selection.
--disable-default-proxy
Disable the default stealth proxy so the browser connects directly. Pass --disable-default-proxy=false to re-enable it.
Make an HTTP request through the browser’s network stack, inheriting its TLS fingerprint, cookies, proxy, and headers. Works like curl, but requests go through the browser session. See Browser curl for examples.
Flag
Description
--request <method>, -X
HTTP method (default: GET).
--header <"Key: Value">, -H
Add a request header (repeatable).
--data <body>, -d
Request body.
--data-file <path>
Read the request body from a file.
--head, -I
Fetch headers only.
--include, -i
Include response headers in the output.
--dump-header <path>, -D
Write received headers to a file (- for stdout).
--output <path>, -o
Write the response body to a file.
--fail, -f
Fail with no body output on HTTP errors.
--silent, -s
Suppress progress output.
--max-time <seconds>
Maximum time allowed for the request (default: 30).
--write-out <format>, -w
Print text after completion (supports %{http_code}, %{time_total}, %{size_download}).
