# Tavus

## Docs

- [Authentication](https://docs.tavus.io/api-reference/authentication.md): Generate an API key in the Developer Portal and send it on each request in the `x-api-key` header.
- [Create conversation](https://docs.tavus.io/api-reference/conversations/create-conversation.md): This endpoint starts a real-time video conversation with your AI replica, powered by a persona that allows it to see, hear, and respond like a human.
- [Delete Conversation](https://docs.tavus.io/api-reference/conversations/delete-conversation.md): This endpoint deletes a single conversation by its unique identifier.
- [End Conversation](https://docs.tavus.io/api-reference/conversations/end-conversation.md): This endpoint ends a single conversation by its unique identifier.
- [Get Conversation](https://docs.tavus.io/api-reference/conversations/get-conversation.md): This endpoint returns a single conversation by its unique identifier.
- [List Conversations](https://docs.tavus.io/api-reference/conversations/get-conversations.md): This endpoint returns a list of all Conversations created by the account associated with the API Key in use.
- [Create Document](https://docs.tavus.io/api-reference/documents/create-document.md): Upload documents to your knowledge base for personas to reference during conversations.
- [Delete Document](https://docs.tavus.io/api-reference/documents/delete-document.md): Delete a document and its associated data using its unique identifier.
- [Get Document](https://docs.tavus.io/api-reference/documents/get-document.md): Retrieve detailed information about a specific document using its unique identifier.
- [List Documents](https://docs.tavus.io/api-reference/documents/get-documents.md): Retrieve a list of documents.
- [Update Document](https://docs.tavus.io/api-reference/documents/patch-document.md): Update a document's `document_name` and `tags`.
- [Recrawl Document](https://docs.tavus.io/api-reference/documents/recrawl-document.md): Trigger a recrawl of a website document to fetch fresh content.
- [Create Guardrails](https://docs.tavus.io/api-reference/guardrails/create-guardrails.md): This endpoint creates a new set of guardrails for a persona. Guardrails provide strict behavioral boundaries and guidelines that will be rigorously followed throughout conversations.
- [Delete Guardrails](https://docs.tavus.io/api-reference/guardrails/delete-guardrails.md): This endpoint deletes a single set of guardrails by its unique identifier.
- [Get Guardrails (One Set)](https://docs.tavus.io/api-reference/guardrails/get-guardrails.md): This endpoint returns a single set of guardrails by its unique identifier.
- [Get Guardrails (All Sets)](https://docs.tavus.io/api-reference/guardrails/get-guardrails-list.md): This endpoint returns a list of all sets of guardrails.
- [Patch Guardrails](https://docs.tavus.io/api-reference/guardrails/patch-guardrails.md): This endpoint allows you to update specific fields of guardrails using JSON Patch operations.
- [Create Objectives](https://docs.tavus.io/api-reference/objectives/create-objectives.md): This endpoint creates objectives for a persona.
- [Delete Objective](https://docs.tavus.io/api-reference/objectives/delete-objectives.md): This endpoint deletes a single objective by its unique identifier.
- [Get Objective](https://docs.tavus.io/api-reference/objectives/get-objectives.md): This endpoint returns a single objective by its unique identifier.
- [Get Objectives](https://docs.tavus.io/api-reference/objectives/get-objectives-list.md): This endpoint returns a list of all objectives.
- [Patch Objective](https://docs.tavus.io/api-reference/objectives/patch-objectives.md): This endpoint allows you to update specific fields of an objective using JSON Patch operations.
- [Overview](https://docs.tavus.io/api-reference/overview.md): Discover the Tavus API — build a real-time, human-like multimodal video conversation with a replica.
- [Create Persona](https://docs.tavus.io/api-reference/personas/create-persona.md): Creates a persona that configures how a replica behaves and sounds in CVI for every conversation that uses that persona.
- [Delete Persona](https://docs.tavus.io/api-reference/personas/delete-persona.md): This endpoint deletes a single persona by its unique identifier.
- [Get Persona](https://docs.tavus.io/api-reference/personas/get-persona.md): This endpoint returns a single persona by its unique identifier.
- [List Personas](https://docs.tavus.io/api-reference/personas/get-personas.md): This endpoint returns a list of all Personas created by the account associated with the API Key in use.
- [Patch Persona](https://docs.tavus.io/api-reference/personas/patch-persona.md): This endpoint allows you to update specific fields of a persona using JSON Patch operations.
- [Create Replica](https://docs.tavus.io/api-reference/phoenix-replica-model/create-replica.md): Creates a new replica from a training video or image URL for use in conversations—see [Which training path?](/sections/replica/which-training-path) for preparation, consent, and media requirements.
- [Delete Replica](https://docs.tavus.io/api-reference/phoenix-replica-model/delete-replica.md): Deletes a Replica by its unique ID; deleted replicas cannot be used in a conversation.
- [Get Replica](https://docs.tavus.io/api-reference/phoenix-replica-model/get-replica.md): This endpoint returns a single Replica by its unique identifier.
- [List Replicas](https://docs.tavus.io/api-reference/phoenix-replica-model/get-replicas.md): This endpoint returns a list of all Replicas created by the account associated with the API Key in use.
- [Rename Replica](https://docs.tavus.io/api-reference/phoenix-replica-model/patch-replica-name.md): This endpoint renames a single Replica by its unique identifier.
- [Create Pronunciation Dictionary](https://docs.tavus.io/api-reference/pronunciation-dictionaries/create-pronunciation-dictionary.md): Create a [pronunciation dictionary](/sections/conversational-video-interface/persona/pronunciation-dictionaries) with custom rules for controlling how words are spoken. Rules are automatically synced to both Cartesia and ElevenLabs so they work regardless of which TTS engine your persona uses.
- [Delete Pronunciation Dictionary](https://docs.tavus.io/api-reference/pronunciation-dictionaries/delete-pronunciation-dictionary.md): Permanently delete a pronunciation dictionary and remove it from all linked personas.
- [Get Pronunciation Dictionary](https://docs.tavus.io/api-reference/pronunciation-dictionaries/get-pronunciation-dictionary.md): Retrieve a pronunciation dictionary by its ID, including all rules.
- [List Pronunciation Dictionaries](https://docs.tavus.io/api-reference/pronunciation-dictionaries/list-pronunciation-dictionaries.md): List all pronunciation dictionaries for the authenticated user with pagination.
- [Update Pronunciation Dictionary](https://docs.tavus.io/api-reference/pronunciation-dictionaries/update-pronunciation-dictionary.md): Update a pronunciation dictionary's name or rules using [JSON Patch](https://jsonpatch.com/) format (RFC 6902). Supported mutable fields are `name` and `rules`.
- [Generate Video](https://docs.tavus.io/api-reference/video-request/create-video.md): This endpoint generates a new video using a Replica and either a script or an audio file.
- [Delete Video](https://docs.tavus.io/api-reference/video-request/delete-video.md): This endpoint deletes a single video by its unique identifier.
- [Get Video](https://docs.tavus.io/api-reference/video-request/get-video.md): This endpoint returns a single video by its unique identifier.
- [List Videos](https://docs.tavus.io/api-reference/video-request/get-videos.md): This endpoint returns a list of all Videos created by the account associated with the API Key in use.
- [Rename Video](https://docs.tavus.io/api-reference/video-request/patch-video-name.md): This endpoint renames a single video by its unique identifier.
- [List Voices](https://docs.tavus.io/api-reference/voices/list-voices.md): Returns available stock **`voice_name`** values and their linked **replica** metadata. When you [Create Replica](/api-reference/phoenix-replica-model/create-replica) with **`train_image_url`** (image-to-replica), **`voice_name`** is required—use this list to pick a valid slug and to preview options.
- [Agents & automation](https://docs.tavus.io/sections/agents-and-automation.md): How to access machine-readable docs and API artifacts for developers, IDEs, and automation - llms.txt, OpenAPI, Agent Skills, and MCP.
- [Changelog](https://docs.tavus.io/sections/changelog/changelog.md)
- [Blocks](https://docs.tavus.io/sections/conversational-video-interface/component-library/blocks.md): High-level component compositions that combine multiple UI elements into complete interface layouts
- [Components](https://docs.tavus.io/sections/conversational-video-interface/component-library/components.md): Learn about our pre-built React components to accelerate integrating the Tavus Conversational Video Interface (CVI) into your application.
- [Hooks](https://docs.tavus.io/sections/conversational-video-interface/component-library/hooks.md): See what hooks Tavus supports for managing video calls, media controls, participant management, and conversation events.
- [Overview](https://docs.tavus.io/sections/conversational-video-interface/component-library/overview.md): Learn how our Tavus Conversational Video Interface (CVI) Component Library can help you go live in minutes.
- [Server](https://docs.tavus.io/sections/conversational-video-interface/component-library/server.md): Server-side helpers for managing Tavus conversation lifecycle without leaking your API key to the browser.
- [Audio-Only Conversation](https://docs.tavus.io/sections/conversational-video-interface/conversation/customizations/audio-only.md): Start a conversation in audio-only mode, perfect for voice-only or low-bandwidth environments.
- [Background Customizations](https://docs.tavus.io/sections/conversational-video-interface/conversation/customizations/background-customizations.md): Apply a green screen or custom background for a personalized visual experience.
- [Call Duration and Timeout](https://docs.tavus.io/sections/conversational-video-interface/conversation/customizations/call-duration-and-timeout.md): Configure call duration and timeout behavior to manage how and when a conversation ends.
- [Closed Captions](https://docs.tavus.io/sections/conversational-video-interface/conversation/customizations/closed-captions.md): Enable closed captions for accessibility or live transcription during conversations.
- [Participant Limits](https://docs.tavus.io/sections/conversational-video-interface/conversation/customizations/participant-limits.md): Control the maximum number of participants allowed in a conversation.
- [Private Rooms](https://docs.tavus.io/sections/conversational-video-interface/conversation/customizations/private-rooms.md): Create authenticated conversations with meeting tokens for enhanced security.
- [Overview](https://docs.tavus.io/sections/conversational-video-interface/conversation/overview.md): Learn how to customize identity and advanced settings for a conversation to suit your needs.
- [Customer Support](https://docs.tavus.io/sections/conversational-video-interface/conversation/usecases/customer-support.md): Engage in real-time customer support and sales conversations with the Customer Support persona (Gloria).
- [Interviewer](https://docs.tavus.io/sections/conversational-video-interface/conversation/usecases/interviewer.md): Engage with the Interviewer persona to run structured, conversational screening interviews.
- [Sales Coach](https://docs.tavus.io/sections/conversational-video-interface/conversation/usecases/sales-coach.md): Engage with the Sales Coach persona to simulate real-time sales conversations.
- [Sales Development Rep](https://docs.tavus.io/sections/conversational-video-interface/conversation/usecases/sales-development-rep.md): Engage with Anna, the Tavus sales development rep persona.
- [FAQs](https://docs.tavus.io/sections/conversational-video-interface/faq.md): Frequently asked questions about Tavus's Conversational Video Interface.
- [Interaction Events](https://docs.tavus.io/sections/conversational-video-interface/interactions-protocols/overview.md): Control CVI conversations by sending and listening to interaction events.
- [Knowledge Base](https://docs.tavus.io/sections/conversational-video-interface/knowledge-base.md): Upload documents to your knowledge base for personas to reference during conversations.
- [Language Support](https://docs.tavus.io/sections/conversational-video-interface/language-support.md): Customize the conversation language using full language names supported by Tavus TTS engines.
- [Memories](https://docs.tavus.io/sections/conversational-video-interface/memories.md): Memories let personas remember information across conversations, allowing participants to have personalized, flowing conversations across multiple sessions.
- [Mobile](https://docs.tavus.io/sections/conversational-video-interface/mobile.md): Ship Tavus CVI on iOS, Android, React Native, and mobile web using Daily's mobile SDKs and the same conversation URLs as web.
- [What is CVI?](https://docs.tavus.io/sections/conversational-video-interface/overview-cvi.md): CVI enables real-time, human-like video interactions through configurable lifelike replicas.
- [Conversational Flow](https://docs.tavus.io/sections/conversational-video-interface/persona/conversational-flow.md): Learn how to configure the Conversational Flow layer to fine-tune turn-taking and interruption handling behavior.
- [Guardrails](https://docs.tavus.io/sections/conversational-video-interface/persona/guardrails.md): Guardrails provide your persona with strict behavioral guidelines that will be rigorously followed throughout every conversation.
- [Large Language Model (LLM)](https://docs.tavus.io/sections/conversational-video-interface/persona/llm.md): Learn how to use Tavus-optimized LLMs or integrate your own custom LLM.
- [Tool Calling for LLM](https://docs.tavus.io/sections/conversational-video-interface/persona/llm-tool.md): Set up tool calling to trigger functions from user speech using Tavus-hosted or custom LLMs.
- [Objectives](https://docs.tavus.io/sections/conversational-video-interface/persona/objectives.md): Objectives are goal-oriented instructions to define the desired outcomes and flow of your conversations.
- [Overview](https://docs.tavus.io/sections/conversational-video-interface/persona/overview.md): Define how your persona behaves, responds, and speaks by configuring layers and pipeline modes.
- [Perception](https://docs.tavus.io/sections/conversational-video-interface/persona/perception.md): Learn how to configure the perception layer with Raven to enable real-time visual and audio understanding.
- [Tool Calling for Perception](https://docs.tavus.io/sections/conversational-video-interface/persona/perception-tool.md): Configure tool calling with Raven to trigger functions from visual or audio input.
- [Pronunciation dictionaries](https://docs.tavus.io/sections/conversational-video-interface/persona/pronunciation-dictionaries.md): Control how your persona pronounces specific words, names, and terms during conversations.
- [Stock Personas](https://docs.tavus.io/sections/conversational-video-interface/persona/stock-personas.md): Tavus offers pre-built personas to help you get started quickly.
- [Speech-to-Text (STT)](https://docs.tavus.io/sections/conversational-video-interface/persona/stt.md): Configure the STT layer to select an STT model, improve transcription accuracy, and optimize for your target languages.
- [Text-to-Speech (TTS)](https://docs.tavus.io/sections/conversational-video-interface/persona/tts.md): Discover how to integrate custom voices from third-party TTS engines for multilingual or localized speech output.
- [AI Prompt: CVI Quickstart](https://docs.tavus.io/sections/conversational-video-interface/quickstart/ai-prompt-cvi-quickstart.md): Copy-paste checklist for Cursor, Copilot, or other AI coding agents to scaffold React (TypeScript, Vite) with Tavus CVI and @tavus/cvi-ui.
- [Conversation Recordings](https://docs.tavus.io/sections/conversational-video-interface/quickstart/conversation-recordings.md): Store conversation recordings in your own S3, GCS, or Azure Blob storage. Federated identity — no secrets shared with Tavus.
- [Customize Conversation UI](https://docs.tavus.io/sections/conversational-video-interface/quickstart/customize-conversation-ui.md): Experience a conversation in a custom Daily UI — styled to match your preference.
- [CVI Quickstart](https://docs.tavus.io/sections/conversational-video-interface/quickstart/cvi-quickstart.md): Create your first persona using the full pipeline and start a conversation in seconds.
- [Emotion Control with Phoenix-4](https://docs.tavus.io/sections/conversational-video-interface/quickstart/emotional-expression.md): Unlock emotionally expressive facial movements and micro-expressions using Phoenix-4 replicas.
- [Pipeline Modes](https://docs.tavus.io/sections/conversational-video-interface/quickstart/pipeline-modes.md): Run CVI with the full Tavus pipeline, Echo mode, or integrate via LiveKit and Pipecat.
- [Errors and Status Details](https://docs.tavus.io/sections/errors-and-status-details.md): Identify errors and status details encountered when using the Tavus platform.
- [Append Conversational Context Interaction](https://docs.tavus.io/sections/event-schemas/conversation-append-context.md)
- [Echo Interaction](https://docs.tavus.io/sections/event-schemas/conversation-echo.md)
- [Interrupt Interaction](https://docs.tavus.io/sections/event-schemas/conversation-interrupt.md)
- [Overwrite Conversational Context Interaction](https://docs.tavus.io/sections/event-schemas/conversation-overwrite-context.md)
- [Perception Analysis Event](https://docs.tavus.io/sections/event-schemas/conversation-perception-analysis.md)
- [Perception Tool Call Event](https://docs.tavus.io/sections/event-schemas/conversation-perception-tool-call.md)
- [Text Respond Interaction](https://docs.tavus.io/sections/event-schemas/conversation-respond.md)
- [Sensitivity Interaction](https://docs.tavus.io/sections/event-schemas/conversation-sensitivity.md)
- [Started/Stopped Speaking Event](https://docs.tavus.io/sections/event-schemas/conversation-started-stopped-speaking.md)
- [Tool Call Event](https://docs.tavus.io/sections/event-schemas/conversation-toolcall.md)
- [Utterance Event](https://docs.tavus.io/sections/event-schemas/conversation-utterance.md)
- [Utterance Streaming Event](https://docs.tavus.io/sections/event-schemas/conversation-utterance-streaming.md)
- [Example Projects](https://docs.tavus.io/sections/example-projects.md)
- [Embed Conversational Video Interface](https://docs.tavus.io/sections/integrations/embedding-cvi.md): Learn how to embed Tavus's Conversational Video Interface (CVI) into your site or app.
- [LiveKit Agent](https://docs.tavus.io/sections/integrations/livekit.md): Integrate a Tavus Replica into LiveKit as the conversational video avatar.
- [Pipecat](https://docs.tavus.io/sections/integrations/pipecat.md): Integrate a Tavus Replica into your Pipecat application as a participant or a video feed for the bot.
- [Introduction](https://docs.tavus.io/sections/introduction.md): Leverage Tavus tools and guides to give your AI Agent real-time human-like perception and presence, bringing the human layer to AI.
- [Models](https://docs.tavus.io/sections/models.md)
- [Reducing Join Latency](https://docs.tavus.io/sections/onboarding-guide/latency-optimization.md): Strategies to reduce perceived and actual latency when starting Tavus conversations
- [Objectives and Guardrails Prompting Guide](https://docs.tavus.io/sections/onboarding-guide/objectives.md): Write clear, testable prompts for objectives and guardrails with practical examples.
- [Persona Strategies](https://docs.tavus.io/sections/onboarding-guide/persona-strategies.md): Two approaches to using personas at scale: reuse with conversational context vs. create-per-session. Choose based on whether you need different data or different behavior per conversation.
- [Prompting Guide](https://docs.tavus.io/sections/onboarding-guide/prompting-guide.md): The recommended structure for writing system prompts for Tavus CVI personas - identity, style, behaviors, and guardrails that work in real-time video conversations.
- [Tavus Tool Calling](https://docs.tavus.io/sections/onboarding-guide/tool-calling-examples.md): Key guidelines for implementing reliable tool calls in Tavus conversational agents
- [What are PALs?](https://docs.tavus.io/sections/other-products/pals.md): AI companion experiences with text, voice, and video—and how they relate to Tavus developer products.
- [Image to Replica](https://docs.tavus.io/sections/replica/image-to-replica-quickstart.md): Create a Phoenix replica from a headshot image and stock voice_name using the Create Replica and Get Replica APIs.
- [Overview](https://docs.tavus.io/sections/replica/overview.md): Understand Tavus replicas, learn how to create your own using a video or an image, or explore ready-to-use stock replicas.
- [Replica FAQs](https://docs.tavus.io/sections/replica/replica-faqs.md)
- [Stock Replicas](https://docs.tavus.io/sections/replica/stock-replicas.md): Start a conversation instantly with our ready-to-use stock replicas - no training required. Stock replicas are prebuilt, high-quality AI agents recorded with real actors and designed for natural, expressive communication. They enable lifelike interactions with dynamic facial expressions, smooth turn…
- [Training from a Video](https://docs.tavus.io/sections/replica/train-with-a-video.md): Phoenix-4 video training requirements, recording structure, and quality guidelines.
- [Training from an Image](https://docs.tavus.io/sections/replica/train-with-an-image.md): Upload a headshot and select a voice_name to create a replica without recording a training video.
- [Video to Replica](https://docs.tavus.io/sections/replica/video-to-replica-quickstart.md): Create a Phoenix replica from a training video using the Create Replica and Get Replica APIs.
- [Which Training Path?](https://docs.tavus.io/sections/replica/which-training-path.md): Compare video-based and image-based Phoenix replica training and open the guide that matches your workflow.
- [Troubleshooting](https://docs.tavus.io/sections/troubleshooting.md): Find solutions to common problems and get back on track quickly with our troubleshooting guides.
- [Background Customizations](https://docs.tavus.io/sections/video/background-customizations.md): Customize AI video backgrounds with transparency, scrolling websites, or custom video sources.
- [Overview](https://docs.tavus.io/sections/video/overview.md): Generate high-quality async videos from a script and a replica—separate from real-time CVI.
- [Quickstart](https://docs.tavus.io/sections/video/quickstart.md): Async Video API walkthrough—render a file from script or audio with a replica; not real-time CVI.
- [Webhooks and Callbacks](https://docs.tavus.io/sections/webhooks-and-callbacks.md): Set up a webhook server to generate a callback URL that receives event notifications from Tavus API.

## OpenAPI Specs

- [openapi](https://docs.tavus.io/openapi.yaml)