API

invalid_state

HTTP 409. Invalid state

What it means

The lifecycle does not allow this now.

What to do

For example accepting an order before delivery, or paying a cancelled order. state is the state that blocked the call; fetch the resource and decide again.

Retrying

Do not retry the same request. Change it first.

Extra members

state: The state that blocked the call.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/invalid_state",
  "title": "Invalid state",
  "status": 409,
  "detail": "The order is awaiting_payment; it cannot be accepted yet.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "invalid_state",
  "request_id": "req_c4v8n2m6x1z3",
  "state": "awaiting_payment"
}

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.