Errors

identity_not_found

404 – No such Identity. The Org has no Identity with that Handle, or it has been deleted.

No such Identity. Answered with 404.

What it means

The Org has no Identity with that Handle, or it has been deleted. Another Org's Identity answers the same way: an Identity that is not yours is one that does not exist.

What to do

List the Org's Identities with GET /api/identities and use a handle from there.

The body

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