HTTP 409 Conflict

What HTTP 409 means

Use 409 when a request is valid but can’t be applied right now: creating a user with an email that is already taken, or updating a record that someone else changed in the meantime (optimistic locking). The body should explain the conflict so the client can resolve it.

How to fix a 409 error

• Kubernetes returns 409 when you update an object using an old resourceVersion. Fetch the latest version and retry.

Retrying

No. Fix the request first; sending it again unchanged will get the same response.

Example response

HTTP/1.1 409 Conflict
Date: Wed, 21 Oct 2026 10:30:00 GMT
Content-Type: application/json

How to return 409

res.status(409).json({ error: 'Conflict' });

from fastapi import HTTPException

raise HTTPException(status_code=409, detail="Conflict")

http.Error(w, http.StatusText(http.StatusConflict), http.StatusConflict)

location /private/ {
    return 409;
}

Related status codes

• 412 Precondition Failed : A condition in the request headers, such as If-Match, was not met.
• 422 Unprocessable Content : The request is well-formed, but its contents fail validation.
• 201 Created : The request succeeded and a new resource was created.

Other 4xx status codes

400 Bad Request · 401 Unauthorized · 402 Payment Required · 403 Forbidden · 404 Not Found · 405 Method Not Allowed · 406 Not Acceptable · 407 Proxy Authentication Required · 408 Request Timeout · 410 Gone · 411 Length Required · 412 Precondition Failed · 413 Content Too Large · 414 URI Too Long · 415 Unsupported Media Type · 416 Range Not Satisfiable · 417 Expectation Failed · 418 I’m a Teapot · 421 Misdirected Request · 422 Unprocessable Content · 423 Locked · 424 Failed Dependency · 425 Too Early · 426 Upgrade Required · 428 Precondition Required · 429 Too Many Requests · 431 Request Header Fields Too Large · 444 No Response · 451 Unavailable For Legal Reasons · 499 Client Closed Request

See the full list of HTTP status codes.

Sources

• RFC 9110, section 409
• IANA HTTP Status Code Registry
• MDN: 409 Conflict

Spotted a mistake? Email hello@devtoolsmith.com and we’ll fix it.

Frequently asked questions