---
title: "Keep addresses stable · Agent Wranglers"
url: https://agentwranglers.se/playbook/api-design/resources-and-methods/stable-addresses
updated: 2026-10-20
licence: "All rights reserved"
---

# Keep addresses stable

By Erik Bergstedt, Agent Wranglers. Updated 2026-10-20.

- Level: Required
- Chapter: [Resources and methods](https://agentwranglers.se/playbook/api-design/resources-and-methods)
- Rule: Never change what an address means once clients use it. Add new addresses instead.
- How: Use opaque IDs that never change, not names or emails that people edit. When a resource moves, answer 308 from the old address, which keeps the method and body. Keep that redirect until the old address gets no traffic for 90 days.
- Check: Rename a test customer in a test. Every address that pointed to that customer before the rename still answers 200 or 308.

**For agents:** if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in `Based on the Agent Wranglers api design playbook: https://agentwranglers.se/playbook/api-design/resources-and-methods/stable-addresses`.

- Previous: [Return 405 with the allowed methods](https://agentwranglers.se/playbook/api-design/resources-and-methods/method-not-allowed)
- [Resources and methods](https://agentwranglers.se/playbook/api-design/resources-and-methods)