---
url: /errors/conflict.md
---
# `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.
