Wat het betekent
Het verzoek botst met de huidige toestand van de resource, zoals een duplicaat of een gelijktijdige bewerking.
Veelvoorkomende oorzaken
- Een record aanmaken dat al bestaat (unieke e-mail of naam)
- Een resource bewerken die iemand anders heeft gewijzigd
- Een versie- of toestandsconflict zoals bij git
Zo los je het op
Als client of bezoeker
Haal de nieuwste toestand op, los het conflict op of kies een andere waarde en probeer het opnieuw.
Als beheerder van de site of API
Leg in de body uit wat botst. Voor optimistische locking met ETags is 412 de preciezere status.
Voorbeeldantwoord
HTTP/1.1
HTTP/1.1 409 Conflict
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Conflict",
"status": 409,
"detail": "A user with this email already exists."
}Specificatie
Veelgestelde vragen
› 409 of 422 voor een dubbel e-mailadres?
Beide worden gebruikt. 409 past bij een conflict met bestaande data, 422 bij een validatieframework. Wees consequent.
› Moeten clients 409 automatisch opnieuw proberen?
Nee; het conflict vraagt meestal een beslissing. Ververs eerst de gegevens.