API

precondition_required

HTTP 428. Precondition required

What it means

If-Match is required and was not sent.

What to do

Send the ETag of the representation you edit in If-Match. get_item returns it. The SDKs can do this for you (if_match="auto").

Retrying

Do not retry the same request. Change it first.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/precondition_required",
  "title": "Precondition required",
  "status": 428,
  "detail": "Send the ETag of the current representation in the If-Match header.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "precondition_required",
  "request_id": "req_c4v8n2m6x1z3"
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.