Skip to main content
POST
/
v2
/
deployments
/
{deployment_id}
/
start
Start Deployment Conversation
curl --request POST \
  --url https://tavusapi.com/v2/deployments/{deployment_id}/start \
  --header 'Content-Type: application/json' \
  --data '
{
  "password": "<string>",
  "conversational_context": "<string>",
  "custom_greeting": "<string>",
  "pal_id": "<string>",
  "memory_stores": [
    "<string>"
  ],
  "captcha_token": "<string>"
}
'
{
  "conversation_id": "<string>",
  "conversation_name": "<string>",
  "conversation_url": "<string>",
  "status": "<string>",
  "callback_url": "<string>",
  "created_at": "<string>",
  "meeting_token": "<string>"
}
For AI agents, use https://docs.tavus.io/openapi.yaml for the full HTTP API contract.

Path Parameters

deployment_id
string
required

Body

application/json
password
string | null
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

Conversation created

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.