Skip to content
Rhino Relay docs

409 idempotency_conflict

HTTP status
409
Code
idempotency_conflict
Title
Idempotency conflict
Meaning
The Idempotency-Key was used with a different request.

What to do

The Idempotency-Key was already used in the last 24 hours with a different method, path or body. Use a new key for a new request, and the same key only to retry the same request.

Where it comes from

  • POST /v1/contacts
  • POST /v1/contacts/batch
  • POST /v1/segments
  • POST /v1/templates
  • POST /v1/templates/{id}/versions
  • POST /v1/campaigns
  • POST /v1/campaigns/{id}/test
  • POST /v1/campaigns/{id}/schedule
  • POST /v1/campaigns/{id}/resume
  • POST /v1/imports/csv
  • POST /v1/imports/mailchimp
  • POST /v1/imports/{id}/commit
  • POST /v1/exports

The response

Errors are application/problem+json (RFC 9457). detail never repeats the values you sent, and type links to this page. Quote requestId if you contact support.

{
  "type": "https://docs.rhinorelay.com/api/errors/idempotency-conflict/",
  "title": "Idempotency conflict",
  "status": 409,
  "code": "idempotency_conflict",
  "detail": "The Idempotency-Key was used with a different request.",
  "requestId": "req_01J9Z8X7W6V5T4S3R2Q1P0N9M8"
}

See it

With $BASE and $KEY set as in the quick start:

Terminal window
curl -X POST "$BASE/segments" -H "Authorization: Bearer $KEY" -H 'Idempotency-Key: segment-customers' \
  -H 'Content-Type: application/json' -d '{"name":"Customers","definition":{"all":[{"type":"tag","tag":"customer"}]}}'


# Expect 409 idempotency_conflict
curl -X POST "$BASE/segments" -H "Authorization: Bearer $KEY" -H 'Idempotency-Key: segment-customers' \
  -H 'Content-Type: application/json' -d '{"name":"Everyone","definition":{}}'

Every error code