Skip to content

resource-conflict

Type URI: https://irvinebroque.com/problems/resource-conflict

HTTP status: 409

Title: Conflict

Default detail: The requested change conflicts with the current resource state.

Client action: Refresh the resource, apply the requested correction, and retry with current state.

Extensions

code
A bounded stable machine code that refines the conflict semantics.
retryable
Whether the client may retry after refreshing current state.
latest
A safe current-state projection when the owning endpoint documents it.
candidates
A bounded list of safe candidate identities when a private coordinator needs owner disambiguation.

Problem-Details header

Responses carry their type and title in the Problem-Details Structured Field using draft-nottingham-problem-header-00. Occurrence detail and instance remain in the body. The JSON problem document takes precedence over conflicting header values.

This problem type is header-compatible. Only these extensions are carried in the field:

code
String
retryable
Boolean

API endpoints can return a more specific detail value for the same type, while keeping this URI stable for machine-readable classification.