---
title: "Resolve retired IDs everywhere · Agent Wranglers"
url: https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/resolve-retired-ids
id: AGT-73
level: Recommended
updated: 2026-10-27
build: a2a6bdfed830
tokens: 649
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Resolve retired IDs everywhere

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-27.

- ID: AGT-73
- Level: Recommended
- Chapter: [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)
- Rule: Every place that accepts an ID follows the map of moved IDs. A lookup of several IDs returns what it found, what moved and what it did not find.
- Check: A request for one current, one retired and one unknown ID gets status 200. It returns the current item, the retired one's replacement marked as moved, and the unknown ID in `not_found`.
- How: Apply the same moved-ID map in redirects, JSON filters, ask endpoints and agent tools. An agent that cached an old ID then still reaches the item. Return `moved` and `not_found` lists instead of failing the whole request, and keep the order asked for. Keep the IDs themselves stable, and list every retired ID with its reason.

## Examples

**Using these examples:** they show one way to follow this rule. Keep the behaviour and the check, not the syntax. Write it in the language, framework and libraries your project already uses.

### HTTP example

```http
GET /api/items?ids=GDE-4,GDE-2,GDE-99 HTTP/1.1
Host: example.com

HTTP/1.1 200 OK
Content-Type: application/json

{"items":[{"id":"GDE-4"},{"id":"GDE-12"}],"moved":{"GDE-2":"GDE-12"},"not_found":["GDE-99"]}
```

## Related rules

- ECM-2 [Reusing a SKU for a different item](https://agentwranglers.se/playbook/ecommerce/catalog-and-prices/never-reuse-skus.md) in E-commerce and fulfilment

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/resolve-retired-ids">Agent Wranglers agents as users playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Answer bursts with 429 instead of a stall](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/burst-answers.md)
- Next: [Use one name for each thing in every agent file](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/one-name-everywhere.md)
- [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)