{"slug":"retell-ai-api","name":"Retell AI API","host":"api.retellai.com","site":"https://retellai.com","category":"communication","docsUrl":null,"sources":[{"kind":"changelog","url":"https://docs.retellai.com/deprecation-notice/overview"},{"kind":"openapi","url":"https://docs.retellai.com/openapi.yaml"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/07-20_agent_version_endpoints"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/07-31_agent_list_endpoints"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/08-31_update_call_ended_calls_only"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/09-15_get_agent_versions"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/09-30_create_web_call_v2"},{"kind":"archive","url":"https://docs.retellai.com/deprecation-notice/2026/12-15_multi_prompt_agents"}],"url":"https://www.okapi.bot/providers/retell-ai-api/","json":"https://www.okapi.bot/api/v1/providers/retell-ai-api.json","breakingChanges":[{"slug":"states-on-post-create-retell-llm-stops-working","api":"retell-ai-api","title":"states on POST /create-retell-llm stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-12-15","scope":null,"calls":["POST /create-retell-llm","body parameter states"],"method":"POST","path":"/create-retell-llm","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/12-15_multi_prompt_agents","kind":"archive"},"quote":"Retell is retiring multi-prompt agents in favor of conversation flow. New multi-prompt creation ends on 12/15/2026, and editing ends on 02/01/2027.","migration":"Build the agent as a conversation flow with POST /create-conversation-flow instead of a multi-prompt Retell LLM.","migrationChange":null,"needsDecision":"Multi-prompt agents have no direct API equivalent: rebuilding one as a conversation flow changes how it handles calls and needs testing.","text":null,"publishedAt":"2026-10-23T10:00:59.362Z","updatedAt":"2026-10-23T10:00:59.362Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/states-on-post-create-retell-llm-stops-working/"},{"slug":"states-on-patch-update-retell-llm-stops-working","api":"retell-ai-api","title":"states on PATCH /update-retell-llm/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2027-02-01","scope":null,"calls":["PATCH /update-retell-llm/{}","body parameter states"],"method":"PATCH","path":"/update-retell-llm/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/12-15_multi_prompt_agents","kind":"archive"},"quote":"Retell is retiring multi-prompt agents in favor of conversation flow. New multi-prompt creation ends on 12/15/2026, and editing ends on 02/01/2027.","migration":"Edit the agent as a conversation flow with PATCH /update-conversation-flow/{conversation_flow_id} instead.","migrationChange":null,"needsDecision":"Multi-prompt agents have no direct API equivalent: rebuilding one as a conversation flow changes how it handles calls and needs testing.","text":null,"publishedAt":"2026-10-23T10:00:59.362Z","updatedAt":"2026-10-23T10:00:59.362Z","status":"upcoming","tone":"risk","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/states-on-patch-update-retell-llm-stops-working/"},{"slug":"get-get-agent-versions-stops-working","api":"retell-ai-api","title":"GET /get-agent-versions/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-09-15","scope":null,"calls":["GET /get-agent-versions/{}"],"method":"GET","path":"/get-agent-versions/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/09-15_get_agent_versions","kind":"archive"},"quote":"The following APIs are deprecated as of 09/15/2026. Migrate to the listed replacements.","migration":"Call GET /list-agent-versions/{agent_id} instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:27.529Z","updatedAt":"2026-10-23T10:00:27.529Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-get-agent-versions-stops-working/"},{"slug":"get-get-chat-agent-versions-stops-working","api":"retell-ai-api","title":"GET /get-chat-agent-versions/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-09-15","scope":null,"calls":["GET /get-chat-agent-versions/{}"],"method":"GET","path":"/get-chat-agent-versions/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/09-15_get_agent_versions","kind":"archive"},"quote":"The following APIs are deprecated as of 09/15/2026. Migrate to the listed replacements.","migration":"Call GET /list-agent-versions/{agent_id} instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:27.529Z","updatedAt":"2026-10-23T10:00:27.529Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-get-chat-agent-versions-stops-working/"},{"slug":"override-dynamic-variables-on-patch-v2-update-call-stops-working","api":"retell-ai-api","title":"override_dynamic_variables on PATCH /v2/update-call/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-08-31","scope":null,"calls":["PATCH /v2/update-call/{}","body parameter override_dynamic_variables"],"method":"PATCH","path":"/v2/update-call/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/08-31_update_call_ended_calls_only","kind":"archive"},"quote":"3. The `override_dynamic_variables` input on Update Call will no longer be accepted.","migration":"Send it to PATCH /v2/update-live-call/{call_id} under fields_to_override.override_dynamic_variables for an ongoing call; drop it for an ended call.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:33.272Z","updatedAt":"2026-10-23T10:00:33.272Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/override-dynamic-variables-on-patch-v2-update-call-stops-working/"},{"slug":"get-list-agents-stops-working","api":"retell-ai-api","title":"GET /list-agents stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-07-31","scope":null,"calls":["GET /list-agents"],"method":"GET","path":"/list-agents","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/07-31_agent_list_endpoints","kind":"archive"},"quote":"The following APIs are deprecated as of 07/31/2026. Migrate to the listed replacements.","migration":"Call POST /v2/list-agents, filtering filter_criteria.channel on voice, and read the results from items.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:19.572Z","updatedAt":"2026-10-23T10:00:19.572Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-agents-stops-working/"},{"slug":"get-list-chat-agents-stops-working","api":"retell-ai-api","title":"GET /list-chat-agents stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-07-31","scope":null,"calls":["GET /list-chat-agents"],"method":"GET","path":"/list-chat-agents","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/07-31_agent_list_endpoints","kind":"archive"},"quote":"The following APIs are deprecated as of 07/31/2026. Migrate to the listed replacements.","migration":"Call POST /v2/list-agents, filtering filter_criteria.channel on chat, and read the results from items.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:19.572Z","updatedAt":"2026-10-23T10:00:19.572Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-chat-agents-stops-working/"},{"slug":"post-publish-agent-stops-working","api":"retell-ai-api","title":"POST /publish-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-07-20","scope":null,"calls":["POST /publish-agent/{}"],"method":"POST","path":"/publish-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/07-20_agent_version_endpoints","kind":"archive"},"quote":"The following APIs are deprecated as of 07/20/2026. Migrate to the listed replacements.","migration":"Call POST /publish-agent-version/{agent_id} instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:23.343Z","updatedAt":"2026-10-23T10:00:23.343Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/post-publish-agent-stops-working/"},{"slug":"post-publish-chat-agent-stops-working","api":"retell-ai-api","title":"POST /publish-chat-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-07-20","scope":null,"calls":["POST /publish-chat-agent/{}"],"method":"POST","path":"/publish-chat-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/07-20_agent_version_endpoints","kind":"archive"},"quote":"The following APIs are deprecated as of 07/20/2026. Migrate to the listed replacements.","migration":"Call POST /publish-agent-version/{agent_id} instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:23.343Z","updatedAt":"2026-10-23T10:00:23.343Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/post-publish-chat-agent-stops-working/"},{"slug":"analysis-successful-prompt-on-patch-update-agent-stops-working","api":"retell-ai-api","title":"analysis_successful_prompt on PATCH /update-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["PATCH /update-agent/{}","body parameter analysis_successful_prompt"],"method":"PATCH","path":"/update-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_call_analysis_data (type system-presets, name call_successful, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-successful-prompt-on-patch-update-agent-stops-working/"},{"slug":"analysis-successful-prompt-on-patch-update-chat-agent-stops-working","api":"retell-ai-api","title":"analysis_successful_prompt on PATCH /update-chat-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["PATCH /update-chat-agent/{}","body parameter analysis_successful_prompt"],"method":"PATCH","path":"/update-chat-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_chat_analysis_data (type system-presets, name chat_successful, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-successful-prompt-on-patch-update-chat-agent-stops-working/"},{"slug":"analysis-successful-prompt-on-post-create-agent-stops-working","api":"retell-ai-api","title":"analysis_successful_prompt on POST /create-agent stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["POST /create-agent","body parameter analysis_successful_prompt"],"method":"POST","path":"/create-agent","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_call_analysis_data (type system-presets, name call_successful, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-successful-prompt-on-post-create-agent-stops-working/"},{"slug":"analysis-successful-prompt-on-post-create-chat-agent-stops-working","api":"retell-ai-api","title":"analysis_successful_prompt on POST /create-chat-agent stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["POST /create-chat-agent","body parameter analysis_successful_prompt"],"method":"POST","path":"/create-chat-agent","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_chat_analysis_data (type system-presets, name chat_successful, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-successful-prompt-on-post-create-chat-agent-stops-working/"},{"slug":"analysis-summary-prompt-on-patch-update-agent-stops-working","api":"retell-ai-api","title":"analysis_summary_prompt on PATCH /update-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["PATCH /update-agent/{}","body parameter analysis_summary_prompt"],"method":"PATCH","path":"/update-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_call_analysis_data (type system-presets, name call_summary, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-summary-prompt-on-patch-update-agent-stops-working/"},{"slug":"analysis-summary-prompt-on-patch-update-chat-agent-stops-working","api":"retell-ai-api","title":"analysis_summary_prompt on PATCH /update-chat-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["PATCH /update-chat-agent/{}","body parameter analysis_summary_prompt"],"method":"PATCH","path":"/update-chat-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_chat_analysis_data (type system-presets, name chat_summary, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-summary-prompt-on-patch-update-chat-agent-stops-working/"},{"slug":"analysis-summary-prompt-on-post-create-agent-stops-working","api":"retell-ai-api","title":"analysis_summary_prompt on POST /create-agent stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["POST /create-agent","body parameter analysis_summary_prompt"],"method":"POST","path":"/create-agent","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_call_analysis_data (type system-presets, name call_summary, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-summary-prompt-on-post-create-agent-stops-working/"},{"slug":"analysis-summary-prompt-on-post-create-chat-agent-stops-working","api":"retell-ai-api","title":"analysis_summary_prompt on POST /create-chat-agent stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["POST /create-chat-agent","body parameter analysis_summary_prompt"],"method":"POST","path":"/create-chat-agent","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_chat_analysis_data (type system-presets, name chat_summary, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-summary-prompt-on-post-create-chat-agent-stops-working/"},{"slug":"analysis-user-sentiment-prompt-on-patch-update-agent-stops-working","api":"retell-ai-api","title":"analysis_user_sentiment_prompt on PATCH /update-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["PATCH /update-agent/{}","body parameter analysis_user_sentiment_prompt"],"method":"PATCH","path":"/update-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_call_analysis_data (type system-presets, name user_sentiment, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-user-sentiment-prompt-on-patch-update-agent-stops-working/"},{"slug":"analysis-user-sentiment-prompt-on-patch-update-chat-agent-stops-working","api":"retell-ai-api","title":"analysis_user_sentiment_prompt on PATCH /update-chat-agent/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["PATCH /update-chat-agent/{}","body parameter analysis_user_sentiment_prompt"],"method":"PATCH","path":"/update-chat-agent/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_chat_analysis_data (type system-presets, name user_sentiment, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-user-sentiment-prompt-on-patch-update-chat-agent-stops-working/"},{"slug":"analysis-user-sentiment-prompt-on-post-create-agent-stops-working","api":"retell-ai-api","title":"analysis_user_sentiment_prompt on POST /create-agent stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["POST /create-agent","body parameter analysis_user_sentiment_prompt"],"method":"POST","path":"/create-agent","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_call_analysis_data (type system-presets, name user_sentiment, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-user-sentiment-prompt-on-post-create-agent-stops-working/"},{"slug":"analysis-user-sentiment-prompt-on-post-create-chat-agent-stops-working","api":"retell-ai-api","title":"analysis_user_sentiment_prompt on POST /create-chat-agent stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["POST /create-chat-agent","body parameter analysis_user_sentiment_prompt"],"method":"POST","path":"/create-chat-agent","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"1. The three prompt fields above will be removed from the API.","migration":"Add a system preset item to post_chat_analysis_data (type system-presets, name user_sentiment, description your prompt) instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/analysis-user-sentiment-prompt-on-post-create-chat-agent-stops-working/"},{"slug":"get-list-batch-tests-stops-working","api":"retell-ai-api","title":"GET /list-batch-tests stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-batch-tests"],"method":"GET","path":"/list-batch-tests","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call GET /v2/list-batch-tests and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-batch-tests-stops-working/"},{"slug":"get-list-chat-stops-working","api":"retell-ai-api","title":"GET /list-chat stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-chat"],"method":"GET","path":"/list-chat","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call POST /v3/list-chats and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-chat-stops-working/"},{"slug":"get-list-conversation-flow-components-stops-working","api":"retell-ai-api","title":"GET /list-conversation-flow-components stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-conversation-flow-components"],"method":"GET","path":"/list-conversation-flow-components","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call GET /v2/list-conversation-flow-components and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-conversation-flow-components-stops-working/"},{"slug":"get-list-conversation-flows-stops-working","api":"retell-ai-api","title":"GET /list-conversation-flows stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-conversation-flows"],"method":"GET","path":"/list-conversation-flows","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call GET /v2/list-conversation-flows and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-conversation-flows-stops-working/"},{"slug":"get-list-phone-numbers-stops-working","api":"retell-ai-api","title":"GET /list-phone-numbers stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-phone-numbers"],"method":"GET","path":"/list-phone-numbers","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call GET /v2/list-phone-numbers and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-phone-numbers-stops-working/"},{"slug":"get-list-retell-llms-stops-working","api":"retell-ai-api","title":"GET /list-retell-llms stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-retell-llms"],"method":"GET","path":"/list-retell-llms","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call GET /v2/list-retell-llms and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-retell-llms-stops-working/"},{"slug":"get-list-test-case-definitions-stops-working","api":"retell-ai-api","title":"GET /list-test-case-definitions stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-test-case-definitions"],"method":"GET","path":"/list-test-case-definitions","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call GET /v2/list-test-case-definitions and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-test-case-definitions-stops-working/"},{"slug":"get-list-test-runs-stops-working","api":"retell-ai-api","title":"GET /list-test-runs/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["GET /list-test-runs/{}"],"method":"GET","path":"/list-test-runs/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call GET /v2/list-test-runs/{test_case_batch_job_id} and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-test-runs-stops-working/"},{"slug":"post-v2-list-calls-stops-working","api":"retell-ai-api","title":"POST /v2/list-calls stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-15","scope":null,"calls":["POST /v2/list-calls"],"method":"POST","path":"/v2/list-calls","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/06-15_legacy_list_endpoints","kind":"archive"},"quote":"After 06/15/2026, the legacy endpoints listed above will no longer be supported.","migration":"Call POST /v3/list-calls and read the results from items, paging with pagination_key while has_more is true.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T09:59:38.020Z","updatedAt":"2026-10-23T09:59:38.020Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/post-v2-list-calls-stops-working/"},{"slug":"inbound-agent-id-on-patch-update-phone-number-stops-working","api":"retell-ai-api","title":"inbound_agent_id on PATCH /update-phone-number/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["PATCH /update-phone-number/{}","body parameter inbound_agent_id"],"method":"PATCH","path":"/update-phone-number/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send inbound_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/inbound-agent-id-on-patch-update-phone-number-stops-working/"},{"slug":"inbound-agent-id-on-post-create-phone-number-stops-working","api":"retell-ai-api","title":"inbound_agent_id on POST /create-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /create-phone-number","body parameter inbound_agent_id"],"method":"POST","path":"/create-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send inbound_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/inbound-agent-id-on-post-create-phone-number-stops-working/"},{"slug":"inbound-agent-id-on-post-import-phone-number-stops-working","api":"retell-ai-api","title":"inbound_agent_id on POST /import-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /import-phone-number","body parameter inbound_agent_id"],"method":"POST","path":"/import-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send inbound_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/inbound-agent-id-on-post-import-phone-number-stops-working/"},{"slug":"inbound-sms-agent-id-on-patch-update-phone-number-stops-working","api":"retell-ai-api","title":"inbound_sms_agent_id on PATCH /update-phone-number/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["PATCH /update-phone-number/{}","body parameter inbound_sms_agent_id"],"method":"PATCH","path":"/update-phone-number/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send inbound_sms_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/inbound-sms-agent-id-on-patch-update-phone-number-stops-working/"},{"slug":"inbound-sms-agent-id-on-post-create-phone-number-stops-working","api":"retell-ai-api","title":"inbound_sms_agent_id on POST /create-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /create-phone-number","body parameter inbound_sms_agent_id"],"method":"POST","path":"/create-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send inbound_sms_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/inbound-sms-agent-id-on-post-create-phone-number-stops-working/"},{"slug":"inbound-sms-agent-id-on-post-import-phone-number-stops-working","api":"retell-ai-api","title":"inbound_sms_agent_id on POST /import-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /import-phone-number","body parameter inbound_sms_agent_id"],"method":"POST","path":"/import-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send inbound_sms_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/inbound-sms-agent-id-on-post-import-phone-number-stops-working/"},{"slug":"outbound-agent-id-on-patch-update-phone-number-stops-working","api":"retell-ai-api","title":"outbound_agent_id on PATCH /update-phone-number/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["PATCH /update-phone-number/{}","body parameter outbound_agent_id"],"method":"PATCH","path":"/update-phone-number/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send outbound_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/outbound-agent-id-on-patch-update-phone-number-stops-working/"},{"slug":"outbound-agent-id-on-post-create-phone-number-stops-working","api":"retell-ai-api","title":"outbound_agent_id on POST /create-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /create-phone-number","body parameter outbound_agent_id"],"method":"POST","path":"/create-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send outbound_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/outbound-agent-id-on-post-create-phone-number-stops-working/"},{"slug":"outbound-agent-id-on-post-import-phone-number-stops-working","api":"retell-ai-api","title":"outbound_agent_id on POST /import-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /import-phone-number","body parameter outbound_agent_id"],"method":"POST","path":"/import-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send outbound_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/outbound-agent-id-on-post-import-phone-number-stops-working/"},{"slug":"outbound-sms-agent-id-on-patch-update-phone-number-stops-working","api":"retell-ai-api","title":"outbound_sms_agent_id on PATCH /update-phone-number/{} stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["PATCH /update-phone-number/{}","body parameter outbound_sms_agent_id"],"method":"PATCH","path":"/update-phone-number/{}","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send outbound_sms_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/outbound-sms-agent-id-on-patch-update-phone-number-stops-working/"},{"slug":"outbound-sms-agent-id-on-post-create-phone-number-stops-working","api":"retell-ai-api","title":"outbound_sms_agent_id on POST /create-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /create-phone-number","body parameter outbound_sms_agent_id"],"method":"POST","path":"/create-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send outbound_sms_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/outbound-sms-agent-id-on-post-create-phone-number-stops-working/"},{"slug":"outbound-sms-agent-id-on-post-import-phone-number-stops-working","api":"retell-ai-api","title":"outbound_sms_agent_id on POST /import-phone-number stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-03-31","scope":null,"calls":["POST /import-phone-number","body parameter outbound_sms_agent_id"],"method":"POST","path":"/import-phone-number","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/03-31_phone_number_agent_fields","kind":"archive"},"quote":"After 03/31/2026, the deprecated single-agent fields will no longer be supported.","migration":"Send outbound_sms_agents instead: a list of {agent_id, agent_version, weight} entries whose weights sum to 1 (one agent: weight 1).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:35.222Z","updatedAt":"2026-10-23T10:00:35.222Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/outbound-sms-agent-id-on-post-import-phone-number-stops-working/"},{"slug":"post-v2-create-web-call-is-deprecated","api":"retell-ai-api","title":"POST /v2/create-web-call is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["POST /v2/create-web-call"],"method":"POST","path":"/v2/create-web-call","source":{"url":"https://docs.retellai.com/deprecation-notice/2026/09-30_create_web_call_v2","kind":"archive"},"quote":"As part of this migration, `POST /v2/create-web-call` will also be deprecated on October 18, 2026 in favor of","migration":"Call POST /v3/create-web-call with the same JSON body; it returns connection details (call_id, access_token), read the call itself with GET /v2/get-call/{call_id}.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:00:31.354Z","updatedAt":"2026-10-23T10:00:31.354Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/retell-ai-api/breaking-changes/post-v2-create-web-call-is-deprecated/"}]}