Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tavus.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Create a Conversation with Participant Limits

Replicas count as participants. For example, max_participants: 2 allows one human participant plus one replica.
1

Step 1: Create Your Conversation

Set max_participants to limit room capacity:
cURL
curl --request POST \
  --url https://tavusapi.com/v2/conversations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api_key>' \
  --data '{
  "persona_id": "pcb7a34da5fe",
  "replica_id": "r90bbd427f71",
  "max_participants": 2
}'
2

Step 2: Join the Conversation

{
  "conversation_id": "ca4301628cb9",
  "conversation_url": "https://tavus.daily.co/ca4301628cb9",
  "status": "active"
}
When the limit is reached, additional users cannot join.