Retell AI

Delete an existing agent via DELETE /delete-agent/{agent_id}

Delete a specific agent version. via DELETE /delete-agent-version/{agent_id}

Delete an App. Fails when agents or knowledge bases still reference it, unless force_delete is set. If a CRM config is linked to this App, the link is cleared. via DELETE /delete-app/{app_id}

Delete an existing chat agent via DELETE /delete-chat-agent/{agent_id}

Delete an existing chat via DELETE /delete-chat/{chat_id}

Delete a contact. A contact linked to a record in a connected CRM cannot be deleted while two-way sync is active — unlink the CRM app first, otherwise the next sync would recreate it. via DELETE /delete-contact/{contact_id}

Delete a conversation flow and all its versions via DELETE /delete-conversation-flow/{conversation_flow_id}

Delete a shared conversation flow component. When deleting a shared component, creates local copies for all linked conversation flows. via DELETE /delete-conversation-flow-component/{conversation_flow_component_id}

Delete an existing knowledge base via DELETE /delete-knowledge-base/{knowledge_base_id}

Delete an existing source from knowledge base via DELETE /delete-knowledge-base-source/{knowledge_base_id}/source/{source_id}

Delete an existing phone number via DELETE /delete-phone-number/{phone_number}

Delete an existing Retell LLM Response Engine via DELETE /delete-retell-llm/{llm_id}

Delete a test case definition via DELETE /delete-test-case-definition/{test_case_definition_id}

Delete a specific call and its associated data via DELETE /v2/delete-call/{call_id}

Retrieve details of a specific agent via GET /get-agent/{agent_id}

Get agent versions. Large version histories may be truncated. via GET /get-agent-versions/{agent_id}. Retell's contract marks this operation deprecated (its description also warns that large version histories may be truncated); prefer retellai_get_list_agent_versions_by_agent_id (GET /list-agent-versions/{agent_id}), which lists stored versions of a voice or chat agent with pagination

Get info about the API key used to authenticate, and the org that owns it. via GET /get-api-key-info

Get an App by id. via GET /get-app/{app_id}

Get the status of the contact analysis data backfill job. via GET /get-backfill-contact-job-status

Get a batch test job by ID via GET /get-batch-test/{test_case_batch_job_id}

Retrieve details of a specific chat agent via GET /get-chat-agent/{agent_id}

Get chat agent versions. Large version histories may be truncated. via GET /get-chat-agent-versions/{agent_id}. Retell's contract marks this operation deprecated (its description also warns that large version histories may be truncated); prefer retellai_get_list_agent_versions_by_agent_id (GET /list-agent-versions/{agent_id}), which lists stored versions of a voice or chat agent with pagination

Retrieve details of a specific chat via GET /get-chat/{chat_id}

Get the current concurrency and concurrency limit of the org via GET /get-concurrency

Retrieve a contact by ID. via GET /get-contact/{contact_id}

Retrieve a contact by phone number. At most one contact exists per phone number in an organization. via GET /get-contact-by-phone/{phone_number}

Status and counts for the org's current or latest contact import. via GET /get-contact-import

Retrieve details of a specific Conversation Flow via GET /get-conversation-flow/{conversation_flow_id}

Get a shared conversation flow component via GET /get-conversation-flow-component/{conversation_flow_component_id}

Get the organization's CRM configuration: which CRM app is linked, the custom contact fields defined for it, and how post-call analysis data is written back to contacts. Returns an empty configuration when nothing has been set up yet. via GET /get-crm-config

Get the contact schema of the connected CRM: the fields available on its contact object, which are the values that sync mappings can reference. via GET /get-crm-schema

Retrieve details of a specific knowledge base via GET /get-knowledge-base/{knowledge_base_id}

Get MCP tools for a specific agent via GET /get-mcp-tools/{agent_id}

Retrieve details of a specific phone number via GET /get-phone-number/{phone_number}

Retrieve details of a specific Retell LLM Response Engine via GET /get-retell-llm/{llm_id}

Get the status of the organization's contact sync, whether it was started manually or by the schedule. Returns status `idle` when no sync is running. via GET /get-sync-job-status

Get a test case definition by ID via GET /get-test-case-definition/{test_case_definition_id}

Get a test case job (test run) by ID via GET /get-test-run/{test_case_job_id}

Retrieve details of a specific voice via GET /get-voice/{voice_id}

List stored versions of a voice or chat agent with pagination. via GET /list-agent-versions/{agent_id}

List the agents and knowledge bases referencing an App, most recently configured first by default. via GET /list-app-usages/{app_id}

List Apps in the organization (paginated). via GET /list-apps

List a contact's conversations (inbound calls, outbound calls, and chats) merged into a single timeline, most recent first. Results are matched by the contact's phone number. Use the returned `pagination_key` to fetch the next page. via GET /list-contact-conversations/{contact_id}

List all knowledge bases via GET /list-knowledge-bases

List all voices available to the user via GET /list-voices

Retrieve details of a specific call via GET /v2/get-call/{call_id}

List batch test jobs with pagination via GET /v2/list-batch-tests

List shared conversation flow components with pagination via GET /v2/list-conversation-flow-components

List conversation flows with pagination via GET /v2/list-conversation-flows

List export requests with pagination via GET /v2/list-export-requests

List phone numbers with pagination via GET /v2/list-phone-numbers

List Retell LLM Response Engines with pagination via GET /v2/list-retell-llms

List test case definitions with pagination via GET /v2/list-test-case-definitions

List test case jobs (test runs) for a batch test job with pagination via GET /v2/list-test-runs/{test_case_batch_job_id}

End an ongoing chat via PATCH /end-chat/{chat_id}

Update an existing agent's latest draft version via PATCH /update-agent/{agent_id}

Partially update an App. Omitted fields remain unchanged. Updating auth_config or tenant metadata invalidates the cached provider token immediately. Providers using the OAuth callback reject auth_config and must be reauthorized through connect-app. via PATCH /update-app/{app_id}

Update an existing chat agent via PATCH /update-chat-agent/{agent_id}

Update metadata and sensitive data storage settings for an existing chat. via PATCH /update-chat/{chat_id}

Update an existing contact. via PATCH /update-contact/{contact_id}

Update an existing conversation flow via PATCH /update-conversation-flow/{conversation_flow_id}

Update an existing shared conversation flow component via PATCH /update-conversation-flow-component/{conversation_flow_component_id}

Update agent bound to a purchased phone number via PATCH /update-phone-number/{phone_number}

Update an existing Retell LLM Response Engine via PATCH /update-retell-llm/{llm_id}

Update metadata and sensitive data storage settings for an existing call. via PATCH /v2/update-call/{call_id}

Update an ongoing call at runtime. Supports overriding dynamic variables, metadata, and the data storage setting on the running call, and controlling the live agent (inject context, trigger a response). These overrides take effect immediately on the live call; metadata and data storage setting changes are also persisted to the call record. To update a call that is no longer ongoing, use /v2/update-call/{call_id}. via PATCH /v2/update-live-call/{call_id}

Add a community voice to the voice library via POST /add-community-voice

Stateless playground completion. Send the full conversation history (same shape as chat completion messages) and receive only the newly generated messages. Nothing is persisted server-side — the caller manages conversation state. via POST /agent-playground-completion/{agent_id}

Trigger a backfill job that re-applies analysis data mappings to contacts using historical call data. Only one backfill job can run per organization at a time. via POST /backfill-contact-analysis-data

Create a new agent via POST /create-agent

Create a new draft agent version from a base version. via POST /create-agent-version/{agent_id}

Create an App: the connection to one external system (a CRM, calendar, support desk, and so on), holding its credentials and settings. Providers with caller-managed credentials accept auth_config. Providers using the OAuth callback must omit auth_config and be authorized through connect-app. Credentials are stored encrypted and never returned. Up to 20 apps per provider. via POST /create-app

Create a batch call via POST /create-batch-call

Create a batch test to run multiple test cases via POST /create-batch-test

Create a chat session via POST /create-chat

Create a new chat agent via POST /create-chat-agent

Create a chat completion message via POST /create-chat-completion

Create a new contact. via POST /create-contact

Start an incremental contact import from an uploaded CSV: creates new contacts and updates existing ones matched by phone number. Mapped columns overwrite the matched contact's fields; unmapped columns are ignored. Runs asynchronously — poll get-contact-import for progress. via POST /create-contact-import

Create a new Conversation Flow that can be attached to an agent. This is used to generate response output for the agent. via POST /create-conversation-flow

Create a new shared conversation flow component via POST /create-conversation-flow-component

Buy a new phone number & Bind agents via POST /create-phone-number

Create a new Retell LLM Response Engine that can be attached to an agent. This is used to generate response output for the agent. via POST /create-retell-llm

Start an outbound SMS chat conversation with a phone number using the specified agent. The agent must be configured for chat mode. The initial SMS message will be automatically generated and sent based on the agent's configuration. via POST /create-sms-chat

Create a new test case definition via POST /create-test-case-definition

Import a phone number from custom telephony & Bind agents via POST /import-phone-number

List contacts, newest conversation first by default, with the total count of matches alongside the page. Page through results with `pagination_key`; `skip` is available for offset-style paging but is slower on large contact sets and can repeat or miss rows as contacts are updated. via POST /list-contacts

Publish an existing draft version in place. via POST /publish-agent-version/{agent_id}

Remove references to resources that no longer exist in your workspace from an agent draft version and its response engine — tools whose app connection has been deleted, unknown knowledge bases, and deleted shared components — and remap voices that are no longer accessible to a default voice. If the agent's response engine version has been published, the engine is left untouched and only agent-level references are repaired. Repairing an agent with nothing to fix is a no-op. via POST /repair-agent/{agent_id}

Start a contact sync with the linked CRM app immediately, instead of waiting for the scheduled sync. One sync runs per organization at a time: starting another while one is in flight is rejected. Poll get-sync-job-status for progress. via POST /run-sync-job

Search for community voices from voice providers via POST /search-community-voice

Probe the App's stored credentials by making a minimal authenticated call to the provider. Returns success=true on a successful round-trip, and records the outcome on the App's connection_status either way. via POST /test-app-auth/{app_id}

Update the organization's CRM configuration. Omitted fields stay as they are; a field that is sent replaces its stored value in full. via POST /update-crm-config

Create a new outbound phone call via POST /v2/create-phone-call

Create a new web call via POST /v2/create-web-call

List unique agents with pagination. via POST /v2/list-agents

Register a new phone call for custom telephony via POST /v2/register-phone-call

Stop an ongoing call. via POST /v2/stop-call/{call_id}

Create a new web call and return browser connection details. via POST /v3/create-web-call

List calls with unified cursor pagination response. via POST /v3/list-calls

List chats with unified cursor pagination response. via POST /v3/list-chats

Rerun post-call analysis for a specific call. This operation incurs charges. via PUT /rerun-call-analysis/{call_id}

Rerun post-chat analysis for a specific chat. This operation incurs charges. via PUT /rerun-chat-analysis/{chat_id}

Update a test case definition via PUT /update-test-case-definition/{test_case_definition_id}