List stuck operations (operator dashboard)

Returns the cross-rail operator dashboard page of operations needing attention, conformed to the shared recovery vocabulary. Each row carries only the verbs SPB can actually perform on it (a verb SPB cannot perform is absent) and the disposition (‘what happens if I do nothing’). Reconciliation cases are shown with their affordances; pre-case stuck-outbound rows the dispatch sweep is retrying are shown informationally with no affordances. No monetary or position fields are returned.

GET /v1/str/stuck-operations

List stuck operations (operator dashboard)

cURL

curl --request GET \
  --url https://api.example.com/v1/str/stuck-operations \
  --header 'Authorization: Bearer <token>'

200

{
  "capabilities": {
    "hasCrashWindowRecovery": true,
    "hasDeadlineExpiry": true,
    "hasDeadlineSweep": true,
    "hasDlqReplay": true,
    "hasInboundStuckDetection": true,
    "rail": "spb",
    "replayNowWired": true,
    "supportedVerbs": [
      "<string>"
    ]
  },
  "correlationId": "<string>",
  "items": [
    {
      "affordances": [
        {
          "requirement": "DIRECT",
          "verb": "RESOLVE",
          "reasonCode": "<string>",
          "semanticsNote": "<string>"
        }
      ],
      "correlation": {
        "operationRef": "<string>",
        "messageType": "STR0008",
        "protocolRef": "<string>"
      },
      "disposition": "SYSTEM_RETRYING",
      "rail": "spb",
      "reason": "STUCK_OUTBOUND",
      "state": "AWAITING_RESPONSE",
      "age": "OVER_15_MIN",
      "detail": {}
    }
  ],
  "limit": 123,
  "nextCursor": "<string>"
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Parámetros de consulta

reason · string

Attention reason filter (e.g. STUCK_OUTBOUND, AWAITING_RAIL_RESPONSE, RETRY_FAILED, REQUIRES_OPERATOR_ACTION)

age · string

Age bucket filter (OVER_5_MIN, OVER_15_MIN, OVER_1_HOUR, OVER_1_DAY)

state · string

Canonical operation state filter (e.g. AWAITING_RESPONSE, REQUIRES_OPERATOR_ACTION, RECOVERY_IN_PROGRESS)

limit · integer<int64> · predeterminado: 50

Page size (default 50, max 100)

Rango requerido: 1 <= x <= 100

cursor · string

Opaque pagination cursor

Respuesta

200

application/json

OK

capabilities · object · requerido

Rail-level honest capability manifest (returned inline to save a round trip).

Show child attributes

correlationId · string · requerido

Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.

items · object[] · requerido

Stuck-operation rows needing operator attention.

Show child attributes

limit · integer<int64> · requerido

Page size applied to this response (max items returned).

nextCursor · string

Opaque cursor for the next page; absent when exhausted. Presence signals more results, absence signals end-of-list.