v2

latestOpenAPI 3.0.4Apache 2.0raw.githubusercontent.com2026-07-1754198241.7 KB
Runs

List connector dead letters

Lists failed items captured for a run after validation, transformation, or destination delivery failure. Dead letters should reference retained payloads rather than embedding them by default so retention and sensitivity policy can control access.

get/runs/{runId}/deadletters

Path parameters

runIdstring uuid required

Stable identifier for a connector route or operation run.

Example:9a785884-63ea-4b07-9976-264a1fc595f1

Stable identifier of a connector route or operation execution.

Query parameters

pageinteger

Zero-based page index.

sizeinteger

Page size.

Response

Paged connector dead letters.

Example response

{
  "data": [
    {
      "deadLetterId": "a7d38149-19d4-4d0e-8af7-f7f8891f73bb",
      "runId": "9a785884-63ea-4b07-9976-264a1fc595f1",
      "routeId": "1e8ff011-2274-4f16-a7dd-bf0b4fd5262f",
      "reason": "Missing required field recipient.email.",
      "createdAt": "2026-06-18T10:21:11Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "page": 0,
    "size": 20,
    "total": 1,
    "totalPages": 1,
    "hasMore": false
  }
}