Elevenlabs API Documentation

ElevenLabs API Documentation

API version: 1.0

Auth

ApiKey xi-api-key in header

Base URL

Not specified.

Setup

1. Set your API key in the appropriate header
2. GET /v1/history -- verify access
3. POST /v1/history/download -- create first download

Endpoints

258 endpoints across 25 groups. See references/api-spec.lap for full details.

history

sound-generation

audio-isolation

voices

text-to-speech

text-to-dialogue

speech-to-speech

text-to-voice

user

studio

dubbing

models

audio-native

shared-voices

similar-voices

usage

pronunciation-dictionaries

service-accounts

workspace

speech-to-text

single-use-token

forced-alignment

convai

music

docs

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "Search history?" -> GET /v1/history
• "Get history details?" -> GET /v1/history/{history_item_id}
• "Delete a history?" -> DELETE /v1/history/{history_item_id}
• "List all audio?" -> GET /v1/history/{history_item_id}/audio
• "Create a download?" -> POST /v1/history/download
• "Create a sound-generation?" -> POST /v1/sound-generation
• "Create a audio-isolation?" -> POST /v1/audio-isolation
• "Create a stream?" -> POST /v1/audio-isolation/stream
• "Delete a sample?" -> DELETE /v1/voices/{voice_id}/samples/{sample_id}
• "List all audio?" -> GET /v1/voices/{voice_id}/samples/{sample_id}/audio
• "Create a with-timestamp?" -> POST /v1/text-to-speech/{voice_id}/with-timestamps
• "Create a stream?" -> POST /v1/text-to-speech/{voice_id}/stream
• "Create a with-timestamp?" -> POST /v1/text-to-speech/{voice_id}/stream/with-timestamps
• "Create a text-to-dialogue?" -> POST /v1/text-to-dialogue
• "Create a stream?" -> POST /v1/text-to-dialogue/stream
• "Create a with-timestamp?" -> POST /v1/text-to-dialogue/stream/with-timestamps
• "Create a with-timestamp?" -> POST /v1/text-to-dialogue/with-timestamps
• "Create a stream?" -> POST /v1/speech-to-speech/{voice_id}/stream
• "Create a create-preview?" -> POST /v1/text-to-voice/create-previews
• "Create a text-to-voice?" -> POST /v1/text-to-voice
• "Create a design?" -> POST /v1/text-to-voice/design
• "Create a remix?" -> POST /v1/text-to-voice/{voice_id}/remix
• "List all stream?" -> GET /v1/text-to-voice/{generated_voice_id}/stream
• "List all subscription?" -> GET /v1/user/subscription
• "List all user?" -> GET /v1/user
• "List all voices?" -> GET /v1/voices
• "Search voices?" -> GET /v2/voices
• "List all default?" -> GET /v1/voices/settings/default
• "List all settings?" -> GET /v1/voices/{voice_id}/settings
• "Get voice details?" -> GET /v1/voices/{voice_id}
• "Delete a voice?" -> DELETE /v1/voices/{voice_id}
• "Create a edit?" -> POST /v1/voices/{voice_id}/settings/edit
• "Create a add?" -> POST /v1/voices/add
• "Create a edit?" -> POST /v1/voices/{voice_id}/edit
• "Create a podcast?" -> POST /v1/studio/podcasts
• "Create a pronunciation-dictionary?" -> POST /v1/studio/projects/{project_id}/pronunciation-dictionaries
• "List all projects?" -> GET /v1/studio/projects
• "Create a project?" -> POST /v1/studio/projects
• "Get project details?" -> GET /v1/studio/projects/{project_id}
• "Delete a project?" -> DELETE /v1/studio/projects/{project_id}
• "Create a content?" -> POST /v1/studio/projects/{project_id}/content
• "Create a convert?" -> POST /v1/studio/projects/{project_id}/convert
• "List all snapshots?" -> GET /v1/studio/projects/{project_id}/snapshots
• "Get snapshot details?" -> GET /v1/studio/projects/{project_id}/snapshots/{project_snapshot_id}
• "Create a stream?" -> POST /v1/studio/projects/{project_id}/snapshots/{project_snapshot_id}/stream
• "Create a archive?" -> POST /v1/studio/projects/{project_id}/snapshots/{project_snapshot_id}/archive
• "List all chapters?" -> GET /v1/studio/projects/{project_id}/chapters
• "Create a chapter?" -> POST /v1/studio/projects/{project_id}/chapters
• "Get chapter details?" -> GET /v1/studio/projects/{project_id}/chapters/{chapter_id}
• "Delete a chapter?" -> DELETE /v1/studio/projects/{project_id}/chapters/{chapter_id}
• "Create a convert?" -> POST /v1/studio/projects/{project_id}/chapters/{chapter_id}/convert
• "List all snapshots?" -> GET /v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots
• "Get snapshot details?" -> GET /v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots/{chapter_snapshot_id}
• "Create a stream?" -> POST /v1/studio/projects/{project_id}/chapters/{chapter_id}/snapshots/{chapter_snapshot_id}/stream
• "List all muted-tracks?" -> GET /v1/studio/projects/{project_id}/muted-tracks
• "Get resource details?" -> GET /v1/dubbing/resource/{dubbing_id}
• "Create a language?" -> POST /v1/dubbing/resource/{dubbing_id}/language
• "Create a segment?" -> POST /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/segment
• "Partially update a segment?" -> PATCH /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}/{language}
• "Create a migrate-segment?" -> POST /v1/dubbing/resource/{dubbing_id}/migrate-segments
• "Delete a segment?" -> DELETE /v1/dubbing/resource/{dubbing_id}/segment/{segment_id}
• "Create a transcribe?" -> POST /v1/dubbing/resource/{dubbing_id}/transcribe
• "Create a translate?" -> POST /v1/dubbing/resource/{dubbing_id}/translate
• "Create a dub?" -> POST /v1/dubbing/resource/{dubbing_id}/dub
• "Partially update a speaker?" -> PATCH /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}
• "Create a speaker?" -> POST /v1/dubbing/resource/{dubbing_id}/speaker
• "List all similar-voices?" -> GET /v1/dubbing/resource/{dubbing_id}/speaker/{speaker_id}/similar-voices
• "List all dubbing?" -> GET /v1/dubbing
• "Create a dubbing?" -> POST /v1/dubbing
• "Get dubbing details?" -> GET /v1/dubbing/{dubbing_id}
• "Delete a dubbing?" -> DELETE /v1/dubbing/{dubbing_id}
• "Get audio details?" -> GET /v1/dubbing/{dubbing_id}/audio/{language_code}
• "Get transcript details?" -> GET /v1/dubbing/{dubbing_id}/transcript/{language_code}
• "Get format details?" -> GET /v1/dubbing/{dubbing_id}/transcripts/{language_code}/format/{format_type}
• "List all models?" -> GET /v1/models
• "Create a audio-native?" -> POST /v1/audio-native
• "List all settings?" -> GET /v1/audio-native/{project_id}/settings
• "Create a content?" -> POST /v1/audio-native/{project_id}/content
• "Create a content?" -> POST /v1/audio-native/content
• "Search shared-voices?" -> GET /v1/shared-voices
• "Create a similar-voice?" -> POST /v1/similar-voices
• "List all character-stats?" -> GET /v1/usage/character-stats
• "Create a add-from-file?" -> POST /v1/pronunciation-dictionaries/add-from-file
• "Create a add-from-rule?" -> POST /v1/pronunciation-dictionaries/add-from-rules
• "Partially update a pronunciation-dictionary?" -> PATCH /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}
• "Get pronunciation-dictionary details?" -> GET /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}
• "Create a set-rule?" -> POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules
• "Create a add-rule?" -> POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/add-rules
• "Create a remove-rule?" -> POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/remove-rules
• "List all download?" -> GET /v1/pronunciation-dictionaries/{dictionary_id}/{version_id}/download
• "List all pronunciation-dictionaries?" -> GET /v1/pronunciation-dictionaries
• "List all api-keys?" -> GET /v1/service-accounts/{service_account_user_id}/api-keys
• "Create a api-key?" -> POST /v1/service-accounts/{service_account_user_id}/api-keys
• "Partially update a api-key?" -> PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}
• "Delete a api-key?" -> DELETE /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}
• "List all service-accounts?" -> GET /v1/service-accounts
• "List all search?" -> GET /v1/workspace/groups/search
• "Create a remove?" -> POST /v1/workspace/groups/{group_id}/members/remove
• "Create a member?" -> POST /v1/workspace/groups/{group_id}/members
• "Create a add?" -> POST /v1/workspace/invites/add
• "Create a add-bulk?" -> POST /v1/workspace/invites/add-bulk
• "Create a member?" -> POST /v1/workspace/members
• "Get resource details?" -> GET /v1/workspace/resources/{resource_id}
• "Create a share?" -> POST /v1/workspace/resources/{resource_id}/share
• "Create a unshare?" -> POST /v1/workspace/resources/{resource_id}/unshare
• "List all webhooks?" -> GET /v1/workspace/webhooks
• "Create a webhook?" -> POST /v1/workspace/webhooks
• "Partially update a webhook?" -> PATCH /v1/workspace/webhooks/{webhook_id}
• "Delete a webhook?" -> DELETE /v1/workspace/webhooks/{webhook_id}
• "Create a speech-to-text?" -> POST /v1/speech-to-text
• "Get transcript details?" -> GET /v1/speech-to-text/transcripts/{transcription_id}
• "Delete a transcript?" -> DELETE /v1/speech-to-text/transcripts/{transcription_id}
• "Create a forced-alignment?" -> POST /v1/forced-alignment
• "List all get-signed-url?" -> GET /v1/convai/conversation/get-signed-url
• "List all get_signed_url?" -> GET /v1/convai/conversation/get_signed_url
• "List all token?" -> GET /v1/convai/conversation/token
• "Create a outbound-call?" -> POST /v1/convai/twilio/outbound-call
• "Create a register-call?" -> POST /v1/convai/twilio/register-call
• "Create a outbound-call?" -> POST /v1/convai/whatsapp/outbound-call
• "Create a outbound-message?" -> POST /v1/convai/whatsapp/outbound-message
• "Create a create?" -> POST /v1/convai/agents/create
• "List all summaries?" -> GET /v1/convai/agents/summaries
• "Get agent details?" -> GET /v1/convai/agents/{agent_id}
• "Partially update a agent?" -> PATCH /v1/convai/agents/{agent_id}
• "Delete a agent?" -> DELETE /v1/convai/agents/{agent_id}
• "List all widget?" -> GET /v1/convai/agents/{agent_id}/widget
• "List all link?" -> GET /v1/convai/agents/{agent_id}/link
• "Create a avatar?" -> POST /v1/convai/agents/{agent_id}/avatar
• "Search agents?" -> GET /v1/convai/agents
• "List all size?" -> GET /v1/convai/agent/{agent_id}/knowledge-base/size
• "Create a calculate?" -> POST /v1/convai/agent/{agent_id}/llm-usage/calculate
• "Create a duplicate?" -> POST /v1/convai/agents/{agent_id}/duplicate
• "Create a simulate-conversation?" -> POST /v1/convai/agents/{agent_id}/simulate-conversation
• "Create a stream?" -> POST /v1/convai/agents/{agent_id}/simulate-conversation/stream
• "Create a create?" -> POST /v1/convai/agent-testing/create
• "Get agent-testing details?" -> GET /v1/convai/agent-testing/{test_id}
• "Update a agent-testing?" -> PUT /v1/convai/agent-testing/{test_id}
• "Delete a agent-testing?" -> DELETE /v1/convai/agent-testing/{test_id}
• "Create a summary?" -> POST /v1/convai/agent-testing/summaries
• "Search agent-testing?" -> GET /v1/convai/agent-testing
• "List all test-invocations?" -> GET /v1/convai/test-invocations
• "Create a run-test?" -> POST /v1/convai/agents/{agent_id}/run-tests
• "Get test-invocation details?" -> GET /v1/convai/test-invocations/{test_invocation_id}
• "Create a resubmit?" -> POST /v1/convai/test-invocations/{test_invocation_id}/resubmit
• "Search conversations?" -> GET /v1/convai/conversations
• "Search users?" -> GET /v1/convai/users
• "Get conversation details?" -> GET /v1/convai/conversations/{conversation_id}
• "Delete a conversation?" -> DELETE /v1/convai/conversations/{conversation_id}
• "List all audio?" -> GET /v1/convai/conversations/{conversation_id}/audio
• "Create a feedback?" -> POST /v1/convai/conversations/{conversation_id}/feedback
• "List all text-search?" -> GET /v1/convai/conversations/messages/text-search
• "List all smart-search?" -> GET /v1/convai/conversations/messages/smart-search
• "Create a phone-number?" -> POST /v1/convai/phone-numbers
• "List all phone-numbers?" -> GET /v1/convai/phone-numbers
• "Get phone-number details?" -> GET /v1/convai/phone-numbers/{phone_number_id}
• "Delete a phone-number?" -> DELETE /v1/convai/phone-numbers/{phone_number_id}
• "Partially update a phone-number?" -> PATCH /v1/convai/phone-numbers/{phone_number_id}
• "Create a calculate?" -> POST /v1/convai/llm-usage/calculate
• "List all list?" -> GET /v1/convai/llm/list
• "Create a file?" -> POST /v1/convai/conversations/{conversation_id}/files
• "Delete a file?" -> DELETE /v1/convai/conversations/{conversation_id}/files/{file_id}
• "List all live-count?" -> GET /v1/convai/analytics/live-count
• "List all summaries?" -> GET /v1/convai/knowledge-base/summaries
• "Create a knowledge-base?" -> POST /v1/convai/knowledge-base
• "Search knowledge-base?" -> GET /v1/convai/knowledge-base
• "Create a url?" -> POST /v1/convai/knowledge-base/url
• "Create a file?" -> POST /v1/convai/knowledge-base/file
• "Create a text?" -> POST /v1/convai/knowledge-base/text
• "Create a folder?" -> POST /v1/convai/knowledge-base/folder
• "Partially update a knowledge-base?" -> PATCH /v1/convai/knowledge-base/{documentation_id}
• "Get knowledge-base details?" -> GET /v1/convai/knowledge-base/{documentation_id}
• "Delete a knowledge-base?" -> DELETE /v1/convai/knowledge-base/{documentation_id}
• "Create a rag-index?" -> POST /v1/convai/knowledge-base/rag-index
• "List all rag-index?" -> GET /v1/convai/knowledge-base/rag-index
• "Create a rag-index?" -> POST /v1/convai/knowledge-base/{documentation_id}/rag-index
• "List all rag-index?" -> GET /v1/convai/knowledge-base/{documentation_id}/rag-index
• "Delete a rag-index?" -> DELETE /v1/convai/knowledge-base/{documentation_id}/rag-index/{rag_index_id}
• "List all dependent-agents?" -> GET /v1/convai/knowledge-base/{documentation_id}/dependent-agents
• "List all content?" -> GET /v1/convai/knowledge-base/{documentation_id}/content
• "List all source-file-url?" -> GET /v1/convai/knowledge-base/{documentation_id}/source-file-url
• "Get chunk details?" -> GET /v1/convai/knowledge-base/{documentation_id}/chunk/{chunk_id}
• "Create a move?" -> POST /v1/convai/knowledge-base/{document_id}/move
• "Create a bulk-move?" -> POST /v1/convai/knowledge-base/bulk-move
• "Create a tool?" -> POST /v1/convai/tools
• "Search tools?" -> GET /v1/convai/tools
• "Get tool details?" -> GET /v1/convai/tools/{tool_id}
• "Partially update a tool?" -> PATCH /v1/convai/tools/{tool_id}
• "Delete a tool?" -> DELETE /v1/convai/tools/{tool_id}
• "List all dependent-agents?" -> GET /v1/convai/tools/{tool_id}/dependent-agents
• "List all settings?" -> GET /v1/convai/settings
• "List all dashboard?" -> GET /v1/convai/settings/dashboard
• "Create a secret?" -> POST /v1/convai/secrets
• "List all secrets?" -> GET /v1/convai/secrets
• "Delete a secret?" -> DELETE /v1/convai/secrets/{secret_id}
• "Partially update a secret?" -> PATCH /v1/convai/secrets/{secret_id}
• "Create a submit?" -> POST /v1/convai/batch-calling/submit
• "List all workspace?" -> GET /v1/convai/batch-calling/workspace
• "Get batch-calling details?" -> GET /v1/convai/batch-calling/{batch_id}
• "Delete a batch-calling?" -> DELETE /v1/convai/batch-calling/{batch_id}
• "Create a cancel?" -> POST /v1/convai/batch-calling/{batch_id}/cancel
• "Create a retry?" -> POST /v1/convai/batch-calling/{batch_id}/retry
• "Create a outbound-call?" -> POST /v1/convai/sip-trunk/outbound-call
• "Create a mcp-server?" -> POST /v1/convai/mcp-servers
• "List all mcp-servers?" -> GET /v1/convai/mcp-servers
• "Get mcp-server details?" -> GET /v1/convai/mcp-servers/{mcp_server_id}
• "Delete a mcp-server?" -> DELETE /v1/convai/mcp-servers/{mcp_server_id}
• "Partially update a mcp-server?" -> PATCH /v1/convai/mcp-servers/{mcp_server_id}
• "List all tools?" -> GET /v1/convai/mcp-servers/{mcp_server_id}/tools
• "Create a tool-approval?" -> POST /v1/convai/mcp-servers/{mcp_server_id}/tool-approvals
• "Delete a tool-approval?" -> DELETE /v1/convai/mcp-servers/{mcp_server_id}/tool-approvals/{tool_name}
• "Create a tool-config?" -> POST /v1/convai/mcp-servers/{mcp_server_id}/tool-configs
• "Get tool-config details?" -> GET /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}
• "Partially update a tool-config?" -> PATCH /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}
• "Delete a tool-config?" -> DELETE /v1/convai/mcp-servers/{mcp_server_id}/tool-configs/{tool_name}
• "Get whatsapp-account details?" -> GET /v1/convai/whatsapp-accounts/{phone_number_id}
• "Partially update a whatsapp-account?" -> PATCH /v1/convai/whatsapp-accounts/{phone_number_id}
• "Delete a whatsapp-account?" -> DELETE /v1/convai/whatsapp-accounts/{phone_number_id}
• "List all whatsapp-accounts?" -> GET /v1/convai/whatsapp-accounts
• "Create a branche?" -> POST /v1/convai/agents/{agent_id}/branches
• "List all branches?" -> GET /v1/convai/agents/{agent_id}/branches
• "Get branche details?" -> GET /v1/convai/agents/{agent_id}/branches/{branch_id}
• "Partially update a branche?" -> PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}
• "Create a merge?" -> POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge
• "Create a deployment?" -> POST /v1/convai/agents/{agent_id}/deployments
• "Create a draft?" -> POST /v1/convai/agents/{agent_id}/drafts
• "Create a plan?" -> POST /v1/music/plan
• "Create a music?" -> POST /v1/music
• "Create a detailed?" -> POST /v1/music/detailed
• "Create a stream?" -> POST /v1/music/stream
• "Create a upload?" -> POST /v1/music/upload
• "Create a stem-separation?" -> POST /v1/music/stem-separation
• "Create a pvc?" -> POST /v1/voices/pvc
• "Create a sample?" -> POST /v1/voices/pvc/{voice_id}/samples
• "Delete a sample?" -> DELETE /v1/voices/pvc/{voice_id}/samples/{sample_id}
• "List all audio?" -> GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/audio
• "List all waveform?" -> GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/waveform
• "List all speakers?" -> GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/speakers
• "Create a separate-speaker?" -> POST /v1/voices/pvc/{voice_id}/samples/{sample_id}/separate-speakers
• "List all audio?" -> GET /v1/voices/pvc/{voice_id}/samples/{sample_id}/speakers/{speaker_id}/audio
• "List all captcha?" -> GET /v1/voices/pvc/{voice_id}/captcha
• "Create a captcha?" -> POST /v1/voices/pvc/{voice_id}/captcha
• "Create a train?" -> POST /v1/voices/pvc/{voice_id}/train
• "Create a verification?" -> POST /v1/voices/pvc/{voice_id}/verification
• "List all docs?" -> GET /docs
• "How to authenticate?" -> See Auth section

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the

…(truncated)