AgentQL Tetra (Remote Chrome Browser)
Create Session
Create a new Tetra browser session.
post/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
request_originstring nullable
Opaque caller-supplied request origin for session attribution
brandingboolean
Whether to show TinyFish branding on the session end screen
Response
Successful Response
session_idstring required
cdp_urlstring required
base_urlstring required