handle_taken

Handle taken. Answered with 409.

What it means

The Handle belongs to an Identity, or did once. A Handle is never reissued – it was a receiving mail address on the brand domain – so a deleted Identity's name stays claimed for all time.

What to do

Choose another Handle and check it with GET /api/handles/{handle} before creating.

The body

{
  "type": "https://tigby.eu/problems/handle_taken",
  "title": "Handle taken",
  "status": 409,
  "detail": "…what was refused, naming this request's own values",
  "code": "handle_taken",
  "doc_url": "https://docs.tigby.eu/errors/handle_taken",
  "agent_hint": "…the next step, for software"
}

Branch on code. The detail names this request's own Handle, id or limit and is not part of the contract.