conflict

Statut HTTP : 409 · Rejouable : non — l'état de la ressource doit changer d'abord.

Cause

L'opération entre en conflit avec l'état actuel de la ressource. C'est le code par défaut de toute réponse 409 qui ne porte pas de code plus précis.

Les conflits courants ont chacun leur code dédié, plus informatif :

• idempotency_key_conflict — clé d'idempotence réutilisée sur un corps différent ;
• DPAE_NOT_CANCELLABLE — envoi DPAE commencé ou soumission non annulable ;
• PARTNER_PAYROLL_BATCH_LOT_CLOSED — lot de paie clôturé ;
• webhook_subscription_duplicate — subscription déjà existante ;
• webhook_subscription_has_deliveries — abonnement qui a encore des livraisons.

Réponse

HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "Conflict",
  "code": "conflict",
  "instance": "/partner/v1/webhooks/subscriptions",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Le detail varie selon l'opération : il décrit le conflit rencontré.

Extensions

Aucune — seuls les champs standard ci-dessus.

Que faire

• Relire le detail : il précise la nature du conflit.
• Relire l'état actuel de la ressource avant de rejouer — un rejeu à l'identique produira le même conflit tant que l'état n'a pas changé.
• Ne pas boucler sur un rejeu automatique : un 409 n'est pas une erreur transitoire.

Voir aussi : Tous les codes d'erreur