v2

latestOpenAPI 3.1.02026-07-2682420.0 KB

AgentQL Tetra (Remote Chrome Browser)

Create Session

Create a new Tetra browser session.

post/v1/tetra/sessions

Request body

browser_ua_preset'windows' | 'macos' | 'linux'

browser_profile'light' | 'stealth' | 'tf-browser'

Browser profile types. LIGHT provides fast headless browsing for standard automation. STEALTH provides enhanced anti-detection capabilities with full browser features TF_BROWSER provides agent-focused capabilities with full browser features.

profile_idstring nullable

ID of a saved browser profile (auth state) to attach for save-back and future hydration; distinct from browser_profile, which selects the browser image.

shutdown_mode'on_disconnect' | 'on_inactivity_timeout'

Controls how a browser session is torn down on disconnect.

inactivity_timeout_secondsinteger

The inactivity timeout in seconds (up to 24h)

sub_user_idstring nullable

Optional sub-user identifier for tracking sessions within a user account

brandingboolean

Whether to show TinyFish branding on the session end screen

Response

Successful Response

session_idstring required

cdp_urlstring required

base_urlstring required