conflict

conflict

Description

The request conflicts with the current state of the resource.

HTTP Status

409 Conflict

doc_url Format

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/conflict

Typical Causes

• The action is not allowed in the current state.
• A unique/idempotency constraint has already been used.
• The resource has changed and no longer satisfies the operation preconditions.

Example

Request:

POST /v1/emailing/messages
Idempotency-Key: 98afdb9d-90d5-46f6-893f-0e8b5ca0b2a9

Response:

{
  "errors": [
    {
      "code": "conflict",
      "message": "Idempotency key already used",
      "doc_url": "https://docs.example.com/errors/conflict"
    }
  ]
}

How To Fix

1. Inspect the current resource state before retrying.
2. Use a new idempotency key when creating a new command.
3. Adjust the operation so it is valid for the current state.