BioFlow / API docs / Errors / idempotency_key_reused

`idempotency_key_reused`

HTTP 422application/problem+json

This Idempotency-Key was already used with a different request.

Open in Claude ↗Open in ChatGPT ↗

What causes it

The Idempotency-Key was already used with a DIFFERENT request body or path — keys bind to one logical request.

How to fix it

Generate a fresh unique key (e.g. a UUID) for every new logical request; reuse a key only for retries of the identical request.

Wire format

Example response body.

{
  "type": "https://getbioflow.com/docs/api/errors/idempotency-key-reused",
  "title": "This Idempotency-Key was already used with a different request",
  "status": 422,
  "instance": "urn:request:req_01abc",
  "code": "idempotency_key_reused",
  "request_id": "req_01abc"
}

Branch on the stable code field — title and detail are for humans and may change. type always resolves to this page. Quote request_id when contacting support. Full code registry on the API docs hub; the complete surface is in the interactive reference.