List dead letters

Lists the request tenant’s parked dead letters for the given queue (rsfn or sfn) NON-destructively — the messages the RSFN / SILOC ingest drivers could not process — available for administrative replay. queue is validated against the allowlist (unknown → 404). RBAC: dlq:read; tenant is always derived from the validated request identity, never a path or payload value.

GET /admin/dlq/{queue}

List dead letters

cURL

curl --request GET \
  --url https://slc.sandbox.lerian.net/admin/dlq/{queue} \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e",
      "queue": "operations.intake.dlq",
      "messageType": "operation.created",
      "reason": "handler returned error after max retries",
      "sourceQueue": "operations.intake"
    }
  ]
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Path Parameters

queue · string · required

Dead-letter queue (rsfn or sfn). An unknown queue is 404.

Example:

"rsfn"

Response

200

application/json

OK

items · object[] | null · required

Parked dead-letter entries for the request tenant on the given queue.

Show child attributes