# GET /list-agents stops working

Calls to GET /list-agents on Retell AI API stopped working on July 31, 2026.

On July 31, 2026, GET /list-agents was removed from the Retell AI API. Requests sent to GET /list-agents fail since that day.

## What to use instead

Call POST /v2/list-agents, filtering filter_criteria.channel on voice, and read the results from items.

- API: Retell AI API (api.retellai.com)
- Kind: Endpoint removal
- Takes effect: July 31, 2026
- Calls after that day: fail
- Calls it hits: `GET /list-agents`
- Source: [Announcement](https://docs.retellai.com/deprecation-notice/2026/07-31_agent_list_endpoints)
- Verified: November 6, 2026, against Retell AI API's own pages
- Page: https://www.okapi.bot/providers/retell-ai-api/breaking-changes/get-list-agents-stops-working/

## Retell AI API's words

> The following APIs are deprecated as of 07/31/2026. Migrate to the listed replacements.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent