{
  "topic": "errors.IDEMPOTENCY_CONFLICT",
  "path": [
    "errors",
    "IDEMPOTENCY_CONFLICT"
  ],
  "title": "IDEMPOTENCY_CONFLICT — duplicate request with conflicting payload",
  "synopsis": "The idempotency key is supplied via the `Idempotency-Key` HTTP header on collection create and update requests. See `crud` for the request shape.",
  "body": "# errors.IDEMPOTENCY_CONFLICT\n\n## STATUS\n\n**Not yet implemented (#91).** The error code is reserved and documented here for the future contract, but no API handler currently reads the `Idempotency-Key` header or raises this error. Duplicate collection requests will currently pass through without detection. Tracked for implementation or removal.\n\n## NAME\n\nIDEMPOTENCY_CONFLICT — a request with the same idempotency key was already received but its payload differs from the original.\n\n## SYNOPSIS\n\nHTTP: `409` `Conflict`. Retryable: `no`.\n\n## DESCRIPTION\n\nThe idempotency key is supplied via the `Idempotency-Key` HTTP header on collection create and update requests. See `crud` for the request shape.\n\nThe server has already processed (or is currently processing) a request with the same idempotency key, but the new request's body or parameters differ from the first one. Idempotency keys protect against duplicate submissions of identical requests; they do not allow modifying the request after the fact.\n\nNot retryable with the same key and a different payload. A distinct operation requires a distinct idempotency key.\n\n## SEE ALSO\n\n- errors\n- errors.CONFLICT\n- errors.TX_CONFLICT\n",
  "sections": [
    {
      "name": "STATUS",
      "body": "**Not yet implemented (#91).** The error code is reserved and documented here for the future contract, but no API handler currently reads the `Idempotency-Key` header or raises this error. Duplicate collection requests will currently pass through without detection. Tracked for implementation or removal."
    },
    {
      "name": "NAME",
      "body": "IDEMPOTENCY_CONFLICT — a request with the same idempotency key was already received but its payload differs from the original."
    },
    {
      "name": "SYNOPSIS",
      "body": "HTTP: `409` `Conflict`. Retryable: `no`."
    },
    {
      "name": "DESCRIPTION",
      "body": "The idempotency key is supplied via the `Idempotency-Key` HTTP header on collection create and update requests. See `crud` for the request shape.\n\nThe server has already processed (or is currently processing) a request with the same idempotency key, but the new request's body or parameters differ from the first one. Idempotency keys protect against duplicate submissions of identical requests; they do not allow modifying the request after the fact.\n\nNot retryable with the same key and a different payload. A distinct operation requires a distinct idempotency key."
    },
    {
      "name": "SEE ALSO",
      "body": "- errors\n- errors.CONFLICT\n- errors.TX_CONFLICT"
    }
  ],
  "see_also": [
    "errors",
    "errors.CONFLICT",
    "errors.TX_CONFLICT"
  ],
  "stability": "stable",
  "actions": []
}