---
title: "Start Phone Call"
method: POST
path: "/v1/teams/{team_id}/phone/calls"
tags: ["operator"]
---

# Start Phone Call

`POST /v1/teams/{team_id}/phone/calls`

## 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}/phone/calls`
- Auth: none declared

Start one outbound call through the governed ``phone.call.start`` action.

The same governance the durable agent's action tool runs — risk-tiered
policy decision plus the action + effect-receipt spine, never a provider
bypass. A routine call is autonomous: a simulation line queues its
provider-free conversation; a carrier line submits the originate and
returns its live status. A policy HOLD returns an
approval receipt; a DENY returns the refusal. Poll the canonical call by
id for progress and the transcript.

## Path parameters

- `team_id` string, uuid, required

## Headers

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

## Request body

- StartPhoneCallRequest
  - `line_id` string, uuid, required
  - `byoc_trunk_sid` string, nullable
  - `carrier_sip` CarrierSipSelection
    - `connection_id` string, uuid, required
    - `external_account_id` string, required
    - `host` string, required
    - `port` integer, nullable
  - `to` string, required
  - `purpose` string
  - `work_item_id` string, uuid, nullable
  - `consent_evidence_id` string, uuid, nullable
  - `idempotency_key` string, nullable
  - `decide_by` string, date-time, nullable
  - `max_call_duration_seconds` integer, nullable

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

> 71 revisions in range; 1 not diffed.

- **2026-09-23** `efbf913206ff`: 1 info
  - the `purpose` request property's maxLength was increased from `500` to `4000`
- **2026-09-15** `9db748966060`: 2 info
  - added the new optional request property `byoc_trunk_sid`
  - added the new optional request property `carrier_sip`
- **2026-09-05** `362369ea5c03`: 1 info
  - added the new optional request property `consent_evidence_id`
- **2026-09-03** `c48c4f626ab0`: 1 info
  - added the new optional request property `max_call_duration_seconds`

[Operation history](https://skmtc.dev/stormy/apis/stormy-control-plane/changes/v1/teams/:team_id/phone/calls/post.md)

---

[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/8f749ef0f9db?raw)