Request a new browser session
POST /api/v1/browser-sessions
Requests a new browser session for the specified agent and tier. Research and account tiers start immediately; payment tier requires human approval.
Authorizations
Request Body required
Request body for creating a new browser session.
Attributes: agent_role: Which C-suite agent is requesting the session. task: Description of the browsing objective. target_url: Starting URL for the session. tier: Autonomy tier (research, account, payment). estimated_cost_usd: Estimated cost for budget tracking.
object
Browser session autonomy tiers.
Controls URL allowlist enforcement and approval routing:
- research: read-only browsing, any URL, no approval
- account: create accounts / accept ToS, pre-approved domains
- payment: purchases with virtual card, requires human approval
Responses
201
Successful Response
Result returned after a browser session lifecycle event.
Returned by request_session(), on_approval(), and
complete_session() to give callers the current state.
Attributes: session_id: Unique session identifier. status: Current lifecycle status. approval_id: AutonomyEngine approval request ID (payment tier). recording_gcs_path: GCS path to rrweb recording JSON. summary: Structured session summary. screenshots: List of GCS screenshot paths. credits_consumed: Credits used during the session. duration_ms: Session duration in milliseconds. error_message: Error description if session failed.
object
Lifecycle states for a browser session.
422
Validation Error