invalid_handle

Invalid Handle. Answered with 400.

What it means

The Handle is not the shape a Handle has: a–z, 0–9 and hyphen, three to 63 characters with hyphens not counting towards the three, no leading or trailing hyphen, and never an xn-- prefix. The detail names the rule it breaks.

What to do

Send a Handle of that shape, and check candidates with GET /api/handles/{handle} first.

The body

{
  "type": "https://tigby.eu/problems/invalid_handle",
  "title": "Invalid Handle",
  "status": 400,
  "detail": "…what was refused, naming this request's own values",
  "code": "invalid_handle",
  "doc_url": "https://docs.tigby.eu/errors/invalid_handle",
  "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.