Skip to main content

HTTP 409 Conflict

The request conflicts with the current state of the resource — e.g. concurrent modification.

4xx · Client error✗ not retryable — fix the request instead

In AI APIs specifically

Seen when cancelling an already-completed batch job or double-submitting with the same idempotency key but different bodies.

Fix checklist

  • Fetch the resource's current state and reconcile.
  • Use idempotency keys consistently — same key must mean same body.

Spec: RFC reference

Related status codes

400 Bad Request

The server cannot process the request due to a client error — malformed JSON, invalid parameters, or schema violations..

401 Unauthorized

Authentication is missing or invalid for this request..

402 Payment Required

The request requires payment — billing is not set up or a balance is exhausted..

403 Forbidden

The server understood the request but refuses to authorize it — valid credentials, insufficient permission..

← All HTTP status codes