create_browser_session
Configure and launch a new browser session with customizable user agent, profile, proxy, and lifecycle settings to automate web interactions.
Instructions
Creates a new Tetra browser session with configurable user agent, profile, proxy, and lifecycle settings. Returns session details needed to connect and interact with the browser.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| browser_ua_preset | No | The operating system user agent preset the browser will identify as, affecting how websites perceive the client environment. | |
| browser_profile | No | The browser profile determining capability and detection resistance: 'light' prioritizes speed with minimal overhead, 'stealth' enables full anti-detection features, and 'tf-browser' uses a custom TF Browser configuration. | |
| shutdown_mode | No | Controls session teardown behavior on disconnect: 'on_disconnect' immediately stops the session when all connections close, while 'on_inactivity_timeout' keeps the session alive to allow reconnection until the inactivity timeout elapses. | |
| inactivity_timeout_seconds | No | How long the session remains alive without active connections before being shut down, applicable when shutdown_mode is 'on_inactivity_timeout'. Accepts values between 5 seconds and 86400 seconds (24 hours). | |
| proxy | No | Proxy server configuration to route browser traffic through for this session, such as host, port, protocol, and credentials. | |
| sub_user_id | No | An optional identifier used to associate this session with a specific sub-user within your account, useful for tracking and auditing sessions across multiple users. |