sandboxes

Create a browser (beta)

Changed on

Beta: create a browser sandbox, which runs one persistent Chrome that other sandboxes attach to. Logins made in it persist across restarts. It keeps its memory when it stops and is never deleted automatically.

post/api/v2/sandboxes/browsers

Request

  • Base URL
    https://api.smith.langchain.com
  • URL
    https://api.smith.langchain.com/api/v2/sandboxes/browsers
  • Auth
    • API key in header X-API-Key
    • or API key in header X-Tenant-Id
    • or HTTP bearer

Request body

hidpiboolean

HiDPI renders pages at twice the resolution, so the live view is sharp on HiDPI screens, at four times the pixels for the browser to render and stream. Off by default, and fixed once the browser is created.

idle_ttl_secondsinteger

IdleTTLSeconds stops the browser after this long without use. A stopped browser resumes with its memory on the next connection. Defaults to the sandbox default; 0 disables the idle stop.

mem_bytesinteger
namestring

Name of the browser sandbox. Generated when omitted, as "browser-" followed by the browser's ID.

vcpusinteger

VCPUs and MemBytes size the browser sandbox, as for any sandbox. With neither set, a browser gets 2 vCPUs and 8 GiB.

Response

Created

hidpiboolean

HiDPI reports whether pages render at twice the resolution. It is reported only while the browser is running.

idstring
namestring
statusstring

Changes