| 402 | A plan limit was reached. | Upgrade under Settings → Billing, or wait for the monthly allowance to reset. |
| 403 | The key’s role does not allow this. | Create a key with a wider role, or do that step yourself. |
| 404 | The id does not exist in this workspace. | The agent should list and try again; ids are never guessed. |
| 409 | The thing is not in the right state: already published, not live, already decided. | Have the agent read the record and adjust. |
| 429 | Too many calls: 600 a minute per key, 60 of them writes. | The agent slows down. If it happens often, the agent is polling; it should use rally_wait_for. |
