HTTP 409Settlement

conflict

Duplicate request (idempotency-key violation).

What this means

A request with the same Idempotency-Key but a different body was already submitted. The server rejects divergent payloads under the same key.

How to recover

Generate a fresh idempotency key for new requests, or send the identical body to replay.

Example response

All TetraFi errors include a stable code, a human-readable message, and a docs_url pointing to this page.

JSON

1{
2  "error": {
3    "code": "conflict",
4    "message": "Duplicate request (idempotency-key violation).",
5    "docs_url": "https://tetrafi.io/docs/integration/errors/conflict/"
6  }
7}

7 linesjson

Match in code

TypeScript

1try {
2  await tetrafi.rfq.create({ /* ... */ });
3} catch (err) {
4  if (err.code === "conflict") {
5    // Generate a fresh idempotency key for new requests, or send the identical body to replay.
6  }
7  throw err;
8}

8 linestypescript

Related settlement errors

404

not_found

Resource (RFQ, quote, order, settlement) not found.

409

quote_expired

Quote window has passed - request a new quote.

409

already_accepted

Quote has already been accepted by another party.

409

rfq_expired

Quote window has passed - create a new RFQ.