Errors
reason_required
400 – A reason is required.
A reason is required. Answered with 400.
What it means
A Staff Console write that is rare and permanent – taking a name out of the customer namespace, putting one back, handing one to an Org, or resuming an account deletion the worker gave up on – is never silent: the audit record is why it happened, and the reason is the one field nothing else in the database can reconstruct.
What to do
Send reason with what was verified and by whom, e.g. the trademark check a release rests on or the outage a resumed deletion was waiting for.
The body
{
"type": "https://tigby.eu/problems/reason_required",
"title": "A reason is required",
"status": 400,
"detail": "…what was refused, naming this request's own values",
"code": "reason_required",
"doc_url": "https://docs.tigby.eu/errors/reason_required",
"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.