handle_taken
409 · Conflicts with the current stateWhat happened
Somebody else already has that handle.
What to do
Pick another. A handle is claimed once and does not come back into circulation when it stops being used, because links to it do not stop existing.
Is retrying worth it
No. Repeating the identical request will fail identically. Something has to change first, and the line above says what.
Reading the response
Errors are RFC 9457 problem details. Switch on code, which is stable, and never on title, which is written for a person and may be reworded or translated. detail carries the specifics of this occurrence, and meta carries whatever the client needs to render the right state instead of a dead end.
Every response also carries an X-Request-Id header. Quote it if you report something — it is what lets us find the exact request.