upstream-service-failure
Type URI: https://irvinebroque.com/problems/upstream-service-failure
HTTP status: 502
Title: Bad Gateway
Default detail: A required upstream service returned an unusable response.
Client action: Retry later and provide requestId to the site owner if the failure persists.
Extensions
requestId- A bounded opaque observability identifier for support correlation.
run- A bounded private run receipt when an owner agent request failed after durable run admission.
draft- A bounded private photo draft receipt when transfer or processing failed after allocation.
receipt- A bounded private workflow receipt when an operation partially completed before its upstream failure.
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 type defines no extensions for transmission in the header.
API endpoints can return a more specific detail value for the same type, while keeping this URI stable for machine-readable classification.