---
title: "Start Deployment Conversation"
method: POST
path: "/v2/deployments/{deployment_id}/start"
tags: ["Deployments"]
---

# Start Deployment Conversation

`POST /v2/deployments/{deployment_id}/start`

Creates a conversation for a deployment. Returns the same fields as [Create Conversation](/api-reference/conversations/create-conversation).

No API key required in the browser. Password, Turnstile, and call-limit checks apply for public callers.

## Path parameters

- `deployment_id` string, required

## Request body

- DeploymentStartRequest
  - `password` string, nullable
  - `conversational_context` string — Per-call context forwarded to the PAL.
  - `custom_greeting` string
  - `pal_id` string — Preview-only PAL override for portal testing.
  - `memory_stores` string[]
  - `captcha_token` string — Cloudflare Turnstile token when captcha is enabled.

## Response `200`

Conversation created

- DeploymentConversationStart — Same shape as Create Conversation.
  - `conversation_id` string
  - `conversation_name` string
  - `conversation_url` string
  - `status` string
  - `callback_url` string
  - `created_at` string
  - `meeting_token` string — Present when `require_auth` is true on the created conversation.

## Other responses

- `400` — Bad Request
- `401` — Authentication required (auth-gated landing pages)
- `404` — Deployment not found or inactive
- `429` — Rate limited or call limit reached

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)