TAtavus
Deployments

Start Deployment Conversation

Creates a conversation for a deployment. Returns the same fields as Create Conversation.

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

post/v2/deployments/{deployment_id}/start

Request

  • Base URL
    https://tavusapi.com
  • URL
    https://tavusapi.com/v2/deployments/{deployment_id}/start
  • Auth
    none required

Path parameters

deployment_idstring required

Request body

passwordstring nullable
conversational_contextstring

Per-call context forwarded to the PAL.

custom_greetingstring

Optional opening line for this start. When set, spoken verbatim. When omitted, the PAL's greeting or dynamic_greeting applies.

pal_idstring

Preview-only PAL override for portal testing.

memory_storesstring[]

Stable visitor identifiers supplied by hosted deployment clients. Multiple values and visitors with existing legacy memory use tag-based memories. With a single value, the server may use it as participant_tag for a PAL-specific Memory Store. memory_store_id is never accepted here.

captcha_tokenstring

Cloudflare Turnstile token when captcha is enabled.

Response

Conversation created

conversation_idstring
conversation_namestring
conversation_urlstring
statusstring
callback_urlstring
created_atstring
meeting_tokenstring

Present when require_auth is true on the created conversation.

Changes

No recorded changes to this operation across all 2 revisions of this API.