---
title: "Open browser"
method: POST
path: "/api/v1/browser/session"
deprecated: true
---

# Open browser

`POST /api/v1/browser/session`

> **Deprecated.**

Open an interactive browser instance for 5 minutes.

## Cookies

- `apikey` string

## Request body

- BrowserSessionRequest — Request model for creating a browser session.
  - `profile_id` string, nullable — The profile ID to use for the browser session. If None, a new profile will be created.
  - `live_view` boolean, nullable — Request a live URL to interact with the browser session.
  - `device` 'desktop' | 'mobile' | 'desktop-lg', nullable — The device type to use.
  - `url` string, nullable — The URL to open in the browser session.
  - `proxy_server` string, nullable — Proxy server address to route browser traffic through.
  - `proxy_username` string, nullable — Proxy server username.
  - `proxy_password` string, password, nullable — Proxy server password.
  - `proxy_id` string, nullable — Name of a Smooth-managed proxy to route browser traffic through, as returned by `list_proxies()`. Cannot be combined with `proxy_server`.
  - `extensions` string[], nullable — List of extensions to install for the task.
  - `use_stealth` boolean — Run the browser in stealth mode. Default is True.

## Response `200`

Successful Response

- ApiResponseBrowserSessionResponse
  - `r` BrowserSessionResponse, required — Browser session response model.
    - `profile_id` string, required — The ID of the browser profile associated with the opened browser instance.
    - `live_id` string, nullable — The ID of the live browser session.
    - `live_url` string, nullable — The live URL to interact with the browser session.
    - `session_id` string, nullable, required — (Deprecated) Returns the session ID.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/smooth/apis/circlemind-zero.md) · [All operations](https://skmtc.dev/smooth/apis/circlemind-zero/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smooth/circlemind-zero/revisions/472956a12adf/schema)