409 Conflict

The HTTP status meaning the request conflicts with the current state of the resource.

In more detail

Typical causes are a change that would break a uniqueness rule, an edit based on an outdated version, or a retry that arrives while the original request with the same idempotency key is still being processed. The client needs to resolve the conflict rather than simply repeat the request.

Example

In the APIs course: the service answers 409 when an idempotency key is reused with a different request body.

Related terms

Taught in

References