> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.usglobalmail.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.usglobalmail.com/_mcp/server.

# Conflict

Returned as `application/problem+json` with `code` `conflict` and HTTP status `409`.

The request cannot be applied because it conflicts with the resource’s current state.

## Common causes

* Creating a duplicate resource.
* A state transition that is not valid from the current state (e.g. archiving mail that is already archived).
* A concurrent modification.

## How to resolve

* Re-fetch the resource to see its current state, then retry the appropriate action.

## Example

```json
{
  "type": "https://docs.usglobalmail.com/api/problems/conflict",
  "title": "The request conflicts with the current state of the resource.",
  "status": 409,
  "code": "conflict",
  "request_id": "req_8f3c2a1b9d",
  "instance": "/v1/mails"
}
```

> **Note**
>
> Retrying without changing the request will not help — fix the request first.