Errors

unknown_flag

404 – No such Flag. A Staff Console write named a Flag nothing declares.

No such Flag. Answered with 404.

What it means

A Staff Console write named a Flag nothing declares. Flags are added to the API's register, not by writing a row: the table holds values and the register holds meaning.

What to do

GET /staff/flags lists every Flag this build declares.

The body

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