List dead-letter events
Lists events that could not be delivered to the project's runtime after all retry attempts, newest first, including failed polling cycles and polled items.
/flows/{projectId}/dead-lettersLists events that could not be delivered to the project's runtime after all retry attempts,
newest first, including failed polling cycles and polled items. Requires the flow:trigger
scope.
Authorization: Bearer bai_ext_.... Tokens belong to one project and carry scopes:
bot:invoke, flow:trigger, automation:trigger.
In: header
Scope: flow:trigger
Path Parameters
The project ID. The token must belong to this project.
Query Parameters
Only events from this source (for example stripe or your polling trigger's source).
true returns only events that have not been replayed.
falsevalue <= 200500 <= value0Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/flows/string/dead-letters"{ "data": [ { "id": "clxa0dl0q0001ab12cd34ef80", "source": "crm", "targetType": "polling", "triggerKey": "new-leads", "requestPayload": { "id": "lead_9922", "name": "Kofi Boateng" }, "failureReason": "Flow invocation failed", "attemptCount": 1, "replayedAt": null, "replayStatus": null, "createdAt": "2026-09-24T09:55:01.000Z", "updatedAt": "2026-09-24T09:55:01.000Z" } ], "total": 1, "limit": 50, "offset": 0}