---
title: "Create Browser Session"
method: POST
path: "/v1/teams/{team_id}/browser/sessions"
tags: ["browser"]
---

# Create Browser Session

`POST /v1/teams/{team_id}/browser/sessions`

## Request

- Base URL: `https://api.stormy.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stormy.ai/v1/teams/{team_id}/browser/sessions`
- Auth: none declared

## Path parameters

- `team_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x-darwin-token` string, nullable

## Request body

- CreateBrowserSessionRequest
  - `url` string, required
  - `surface_id` string, required
  - `restart` boolean
  - `viewport` BrowserViewportRequest
    - `width` integer
    - `height` integer
    - `refresh_rate` integer

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stormy/apis/stormy-control-plane.md) · [All operations](https://skmtc.dev/stormy/apis/stormy-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/stormy/apis/stormy-control-plane/revisions/4d811ab18158?raw)