# agent_ids on GET /v1/runs is deprecated

Letta API deprecated GET /v1/runs, query parameter agent_ids without giving a shutdown date yet.

The provider deprecated the agent_ids query parameter on the GET /v1/runs endpoint without a shutdown date. This change affects requests using agent_ids to specify agent identifiers associated with a run. Once removed, calls relying on this parameter fail.

## What to use instead

Filter runs with the agent_id query parameter instead.

- API: Letta API (api.letta.com)
- Kind: Endpoint removal
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /v1/runs`, `query parameter agent_ids`
- Source: [Announcement](https://docs.letta.com/api/resources/runs/index.md)
- Verified: October 26, 2026, against Letta API's own pages
- Page: https://www.okapi.bot/providers/letta-api/breaking-changes/agent-ids-on-get-v1-runs-is-deprecated/

## Letta API's words

> The unique identifiers of the agents associated with the run. Deprecated in favor of agent_id field.

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