API

idempotency_key_required

HTTP 400. Idempotency key required

What it means

A call that moves money was sent without an Idempotency-Key.

What to do

Send Idempotency-Key with create_order, pay_order, back_project and transfer_units. The SDKs and the CLI add one. With curl use -H "Idempotency-Key: $(uuidgen)". See idempotency.

Retrying

Do not retry the same request. Change it first.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/idempotency_key_required",
  "title": "Idempotency key required",
  "status": 400,
  "detail": "Send an Idempotency-Key header with this request.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "idempotency_key_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.