---
title: "Start Web Voice Session"
method: POST
path: "/v1/teams/{team_id}/web-voice/sessions"
tags: ["web voice"]
---

# Start Web Voice Session

`POST /v1/teams/{team_id}/web-voice/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}/web-voice/sessions`
- Auth: none declared

## Path parameters

- `team_id` string, uuid, required

## Headers

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

## Request body

- WebVoiceSessionRequest: Attach browser speech to the conversation already open in the web app.
  - `agent_session_id` string, uuid, required
  - `surface` BrowserSurfaceContext, required: The shell's bounded observation when the owner starts a web call.
    - `pathname` string
    - `label` string, required
    - `ref` string, nullable
    - `kind` 'onboarding' | 'conversation' | 'place' | 'screen' | 'record' | 'website', required

## 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)