Appearance

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:

http
POST /v1/premium-scheduling/single-premium-requests/019d1f3c-42b6-4375-bec9-1dcf0ff0f385/cancel

Response:

json
{
  "errors": [
    {
      "code": "conflict",
      "message": "Only PENDING single premium requests can be cancelled",
      "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.