Error Codes Wiki

HTTP 409 Conflict — Resource State Conflict

Warning4xx client error

Overview

HTTP 409 Conflict means the request conflicts with the current state of the resource.

Key Details

  • Status: 409 Conflict
  • Category: 4xx Client Error
  • Request conflicts with current resource state
  • Client should resolve the conflict and retry

Common Causes

  • Trying to create a resource that already exists
  • Editing a resource that was modified by someone else
  • Version conflict in optimistic locking
  • Duplicate entry in database

Steps

  1. 1Read the response body for conflict details
  2. 2Fetch the current resource state
  3. 3Resolve the conflict (merge changes, rename, etc.)
  4. 4Retry the request with updated data

Tags

http-status4xx-client-errorhttp-409httpstatus-code

More in 4xx Client Error

Frequently Asked Questions

When your request contradicts the current state — like creating a duplicate.