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.

​
Customize Background in Conversation Setup

1

Step 1: Create Your Conversation

In this example, we will use stock replica ID r90bbd427f71 (Anna) and stock persona ID pcb7a34da5fe (Sales Development Rep).
To apply the green screen background, set the apply_greenscreen parameter to true when creating the conversation:
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",
  "callback_url": "https://yourwebsite.com/webhook",
  "conversation_name": "Improve Sales Technique",
  "conversational_context": "I want to improve my sales techniques. Help me practice handling common objections from clients and closing deals more effectively.",
  "properties": {
    "apply_greenscreen": true
   }
}'
Replace <api_key> with your actual API key. You can generate one in the Developer Portal.
2

Step 2: Customize the Background

The above request will return the following response:
{
  "conversation_id": "ca4301628cb9",
  "conversation_name": "Improve Sales Technique",
  "conversation_url": "<conversation_link>",
  "status": "active",
  "callback_url": "https://yourwebsite.com/webhook",
  "created_at": "2025-05-13T06:42:58.291561Z"
}
The replica will appear with a green background. You can customize it using a WebGL-based on the front-end. This allows you to apply a different color or add a custom image.
To preview this feature, try our Green Screen Sample App. Paste the conversation URL to modify the background.