idempotency_key_reused
This Idempotency-Key was already used with a different request. What causes the BioFlow API's idempotency_key_reused error (HTTP 422) and how to fix it.
HTTP 422 · application/problem+json · This Idempotency-Key was already used with a different request.
What causes it
- The
Idempotency-Keywas 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.
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 (https://getbioflow.com/docs/api/errors/idempotency-key-reused) 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.
idempotency_in_progress
A request with this Idempotency-Key is still executing. What causes the BioFlow API's idempotency_in_progress error (HTTP 409) and how to fix it.
endpoint_verification_failed
The webhook endpoint did not accept the signed test event. What causes the BioFlow API's endpoint_verification_failed error (HTTP 422) and how to fix it.