The Retell Community is where innovators, call center leaders, and AI enthusiasts come together to share ideas, learn best practices, and explore the future of voice automation. Join to connect with peers, get early access to product updates, and collaborate on building human-like AI voice experiences that transform customer service.

Retell AI

<@1145576664366055464> - I need info on: Legacy agent list endpoints

Thanks for tagging me <@1404382443263492209>. I'll look through relevant sources and get back to you shortly.

### Answer
 The legacy agent list endpoints `GET /list-agents` and `GET /list-chat-agents` were removed on July 31, 2026 [(1) ](<https://docs.retellai.com/deprecation-notice/2026/07-31_agent_list_endpoints>) . These endpoints have been replaced by the unified `POST /v2/list-agents` endpoint .

**Migration details:**

To list only voice agents, set `filter_criteria.channel` to `{ "op": "eq", "value": "voice" }` .

To list only chat agents, set `filter_criteria.channel` to `{ "op": "eq", "value": "chat" }` .

Read results from `items` instead of expecting a top-level array .

Continue pagination with the returned `pagination_key` while `has_more` is `true` .

The new endpoint returns one unified list for voice and chat agents . Use the `channel` filter to preserve the old voice-only or chat-only behavior, and update any array-based response handling to read from `items` .

​
To learn more, see the sources I considered:

[[1] Legacy agent list endpoints removed (07/31/2026)](https://docs.retellai.com/deprecation-notice/2026/07-31_agent_list_endpoints)
​

Feel free to tag <@1145576664366055464> with additional questions. I also appreciate feedback, it helps me improve.