Deprecating on 06/15/2026

​

Legacy list endpoints are deprecated

• List Batch Tests
• List Conversation Flow Components
• List Conversation Flows
• List Phone Numbers
• List Retell LLMs
• List Test Case Definitions
• List Test Runs
• List Calls
• List Chats

​

Endpoint migrations

• GET /list-batch-tests -> GET /v2/list-batch-tests (List Batch Tests)
• GET /list-conversation-flow-components -> GET /v2/list-conversation-flow-components (List Conversation Flow Components)
• GET /list-conversation-flows -> GET /v2/list-conversation-flows (List Conversation Flows)
• GET /list-phone-numbers -> GET /v2/list-phone-numbers (List Phone Numbers)
• GET /list-retell-llms -> GET /v2/list-retell-llms (List Retell LLMs)
• GET /list-test-case-definitions -> GET /v2/list-test-case-definitions (List Test Case Definitions)
• GET /list-test-runs/{test_case_batch_job_id} -> GET /v2/list-test-runs/{test_case_batch_job_id} (List Test Runs)
• POST /v2/list-calls -> POST /v3/list-calls (List Calls)
• GET /list-chat -> POST /v3/list-chats (List Chats)

1. The legacy list endpoints above will no longer be supported.
2. GET /list-chat changes both method and path to POST /v3/list-chats.
3. Versioned list endpoints return unified pagination fields: items, pagination_key, and has_more.

• Update each client call to the new method/path listed above.
• Update response handling to read items from the paginated response object (instead of expecting a top-level array from legacy endpoints).
• Keep using pagination_key and has_more for page traversal.

​

Analysis prompt fields are deprecated

• analysis_summary_prompt
• analysis_successful_prompt
• analysis_user_sentiment_prompt

• Create Agent / Update Agent
• Create Chat Agent / Update Chat Agent

1. The three prompt fields above will be removed from the API.
2. Use system preset items inside post_call_analysis_data (voice agents) or post_chat_analysis_data (chat agents) to customize prompts for summary, success, and sentiment analysis.

{
  "analysis_summary_prompt": "Summarize the outcome of the conversation in two sentences."
}