Skip to content
Search documentation/

Idempotency key required

idempotency_key_missingHTTP 400Don't retry

What happened

Requests that change something need an Idempotency-Key, so a retry can never act twice. Nothing was done.

What to do next

Add an Idempotency-Key header of 16 to 255 characters, unique to this operation, then send the request.

Can you retry?

Don't retry. Don't repeat this request. Fix what the response describes, or stop and report it. retry: never

Who acts

You: the software that sent the request. who_acts: caller

Don't

  • Don't send the same request again unchanged; it will be refused the same way. repeat_unchanged

Example response

Sent as application/problem+json. The detail describes the particular request; keep request_id for support.

{
  "type": "https://docs.perionpayments.com/problems/idempotency-key-missing",
  "title": "Idempotency key required",
  "status": 400,
  "code": "idempotency_key_missing",
  "detail": "Requests that change something need an Idempotency-Key, so a retry can never act twice. Nothing was done.",
  "request_id": "req_8YkQ2rL0ZtW4",
  "retryable": false,
  "retry": "never",
  "who_acts": "caller",
  "next_step": "Add an Idempotency-Key header of 16 to 255 characters, unique to this operation, then send the request.",
  "do_not": [
    "repeat_unchanged"
  ]
}

All problem codes · Reading problem responses