AGagentql
AgentQL Tetra (Remote Chrome Browser)

Create Session

Changed on

Create a new Tetra browser session.

post/v1/tetra/sessions

Request

Request body

browser_ua_preset'windows' | 'macos' | 'linux'
browser_profile'light' | 'stealth' | 'tf-browser' | 'tf-browser-154'

Browser profile types. LIGHT provides fast headless browsing for standard automation. TF_BROWSER provides agent-focused capabilities with full browser features. TF_BROWSER_154 is the TF Browser on Chromium 154. TF_BROWSER (Chromium 147) and TF_BROWSER_154 are separate profiles, not two builds of one: each has its own image, its own anti-bot persona and its own tetra engine. A 147 persona or image never serves a 154 session, and the reverse. STEALTH is retired as a distinct profile (the anchor browser is gone): request models accept it as a deprecated alias of TF_BROWSER (see RequestBrowserProfile). The member survives so stored rows (telemetry mode, usage) still parse.

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)

session_max_duration_secondsinteger nullable

The hard session duration 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

Changes

  • 535d519081daRevision changes
    • info

      added the new tf-browser-154 enum value to the request property /

  • dbd5470f7f0fRevision changes
    • info

      added the new optional request property /