api.md

Call

Types:

from retell.types import CallResponse, PhoneCallResponse, WebCallResponse, CallListResponse

Methods:

• client.call.retrieve(call_id) -> CallResponse
• client.call.update(call_id, **params) -> CallResponse
• client.call.list(**params) -> CallListResponse
• client.call.delete(call_id) -> None
• client.call.create_phone_call(**params) -> PhoneCallResponse
• client.call.create_web_call(**params) -> WebCallResponse
• client.call.register_phone_call(**params) -> PhoneCallResponse

Chat

Types:

from retell.types import ChatResponse, ChatListResponse, ChatCreateChatCompletionResponse

Methods:

• client.chat.create(**params) -> ChatResponse
• client.chat.retrieve(chat_id) -> ChatResponse
• client.chat.update(chat_id, **params) -> ChatResponse
• client.chat.list(**params) -> ChatListResponse
• client.chat.create_chat_completion(**params) -> ChatCreateChatCompletionResponse
• client.chat.create_sms_chat(**params) -> ChatResponse
• client.chat.end(chat_id) -> None

PhoneNumber

Types:

from retell.types import PhoneNumberResponse, PhoneNumberListResponse

Methods:

• client.phone_number.create(**params) -> PhoneNumberResponse
• client.phone_number.retrieve(phone_number) -> PhoneNumberResponse
• client.phone_number.update(phone_number, **params) -> PhoneNumberResponse
• client.phone_number.list() -> PhoneNumberListResponse
• client.phone_number.delete(phone_number) -> None
• client.phonenumber.import(**params) -> PhoneNumberResponse

Agent

Types:

from retell.types import AgentResponse, AgentListResponse, AgentGetVersionsResponse

Methods:

• client.agent.create(**params) -> AgentResponse
• client.agent.retrieve(agent_id, **params) -> AgentResponse
• client.agent.update(agent_id, **params) -> AgentResponse
• client.agent.list(**params) -> AgentListResponse
• client.agent.delete(agent_id) -> None
• client.agent.get_versions(agent_id) -> AgentGetVersionsResponse
• client.agent.publish(agent_id) -> None

ChatAgent

Types:

from retell.types import ChatAgentResponse, ChatAgentListResponse, ChatAgentGetVersionsResponse

Methods:

• client.chat_agent.create(**params) -> ChatAgentResponse
• client.chat_agent.retrieve(agent_id, **params) -> ChatAgentResponse
• client.chat_agent.update(agent_id, **params) -> ChatAgentResponse
• client.chat_agent.list(**params) -> ChatAgentListResponse
• client.chat_agent.delete(agent_id) -> None
• client.chat_agent.get_versions(agent_id) -> ChatAgentGetVersionsResponse
• client.chat_agent.publish(agent_id) -> None

Llm

Types:

from retell.types import LlmResponse, LlmListResponse

Methods:

• client.llm.create(**params) -> LlmResponse
• client.llm.retrieve(llm_id, **params) -> LlmResponse
• client.llm.update(llm_id, **params) -> LlmResponse
• client.llm.list(**params) -> LlmListResponse
• client.llm.delete(llm_id) -> None

ConversationFlow

Types:

from retell.types import ConversationFlowResponse, ConversationFlowListResponse

Methods:

• client.conversation_flow.create(**params) -> ConversationFlowResponse
• client.conversation_flow.retrieve(conversation_flow_id, **params) -> ConversationFlowResponse
• client.conversation_flow.update(conversation_flow_id, **params) -> ConversationFlowResponse
• client.conversation_flow.list(**params) -> ConversationFlowListResponse
• client.conversation_flow.delete(conversation_flow_id) -> None

ConversationFlowComponent

Types:

from retell.types import ConversationFlowComponentResponse, ConversationFlowComponentListResponse

Methods:

• client.conversation_flow_component.create(**params) -> ConversationFlowComponentResponse
• client.conversation_flow_component.retrieve(conversation_flow_component_id) -> ConversationFlowComponentResponse
• client.conversation_flow_component.update(conversation_flow_component_id, **params) -> ConversationFlowComponentResponse
• client.conversation_flow_component.list() -> ConversationFlowComponentListResponse
• client.conversation_flow_component.delete(conversation_flow_component_id) -> None

KnowledgeBase

Types:

from retell.types import KnowledgeBaseResponse, KnowledgeBaseListResponse

Methods:

• client.knowledge_base.create(**params) -> KnowledgeBaseResponse
• client.knowledge_base.retrieve(knowledge_base_id) -> KnowledgeBaseResponse
• client.knowledge_base.list() -> KnowledgeBaseListResponse
• client.knowledge_base.delete(knowledge_base_id) -> None
• client.knowledge_base.add_sources(knowledge_base_id, **params) -> KnowledgeBaseResponse
• client.knowledge_base.delete_source(source_id, *, knowledge_base_id) -> KnowledgeBaseResponse

Voice

Types:

from retell.types import VoiceResponse, VoiceListResponse, VoiceSearchResponse

Methods:

• client.voice.retrieve(voice_id) -> VoiceResponse
• client.voice.list() -> VoiceListResponse
• client.voice.add_resource(**params) -> VoiceResponse
• client.voice.clone(**params) -> VoiceResponse
• client.voice.search(**params) -> VoiceSearchResponse

Concurrency

Types:

from retell.types import ConcurrencyRetrieveResponse

Methods:

• client.concurrency.retrieve() -> ConcurrencyRetrieveResponse

BatchCall

Types:

from retell.types import BatchCallResponse

Methods:

• client.batch_call.create_batch_call(**params) -> BatchCallResponse

Tests

Types:

from retell.types import (
    BatchTestResponse,
    TestCaseDefinitionResponse,
    TestCaseJobResponse,
    TestListBatchTestsResponse,
    TestListTestCaseDefinitionsResponse,
    TestListTestRunsResponse,
)

Methods:

• client.tests.create_batch_test(**params) -> BatchTestResponse
• client.tests.create_test_case_definition(**params) -> TestCaseDefinitionResponse
• client.tests.delete_test_case_definition(test_case_definition_id) -> None
• client.tests.get_batch_test(test_case_batch_job_id) -> BatchTestResponse
• client.tests.get_test_case_definition(test_case_definition_id) -> TestCaseDefinitionResponse
• client.tests.get_test_run(test_case_job_id) -> TestCaseJobResponse
• client.tests.list_batch_tests(**params) -> TestListBatchTestsResponse
• client.tests.list_test_case_definitions(**params) -> TestListTestCaseDefinitionsResponse
• client.tests.list_test_runs(test_case_batch_job_id) -> TestListTestRunsResponse
• client.tests.update_test_case_definition(test_case_definition_id, **params) -> TestCaseDefinitionResponse

McpTool

Types:

from retell.types import McpToolDefinition, McpToolGetMcpToolsResponse

Methods:

• client.mcp_tool.get_mcp_tools(agent_id, **params) -> McpToolGetMcpToolsResponse