API

precondition_failed

HTTP 412. Precondition failed

What it means

If-Match is stale: the resource changed since you read it.

What to do

current_etag is the value to use. Read the resource again, apply your change to the new version and retry with the new ETag. See conditional requests.

Retrying

Do not retry the same request. Change it first.

Extra members

current_etag: The current ETag of the resource.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/precondition_failed",
  "title": "Precondition failed",
  "status": 412,
  "detail": "The resource changed since you fetched it. Fetch it again and retry with the new ETag.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "precondition_failed",
  "request_id": "req_c4v8n2m6x1z3",
  "current_etag": "\"9f2c61d0a4b87e35\""
}

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.