Errors

invalid_flag_value

400 – Not a value this Flag takes. A Staff Console write named a value the Flag does not declare.

Not a value this Flag takes. Answered with 400.

What it means

A Staff Console write named a value the Flag does not declare. The register in the API is what says which values a Flag takes, and a value nothing declares would be read as the Flag's default, silently.

What to do

GET /staff/flags lists the values each Flag takes, in the order to offer them.

The body

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