DUduda
Partner webhooks dead letters API

List dead letters

Returns a page of dead-letter items, optionally filtered by event type, failure time range, and resource.

post/api/sites/multiscreen/webhooks/dead-letters/query

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/webhooks/dead-letters/query
  • Auth
    HTTP basic

Request body

event_typesstring[]

Filter by webhook event types. If omitted, all event types are considered.

failed_fromstring date-time

Include dead letters created at or after this UTC timestamp (inclusive).

failed_tostring date-time

Include dead letters created at or before this UTC timestamp (inclusive).

limitinteger

Maximum number of results to return.

offsetinteger

Zero-based offset for pagination.

Example request

{
  "event_types": [
    "PUBLISH",
    "DOMAIN_UPDATED"
  ],
  "failed_from": "2026-01-01T00:00:00Z",
  "failed_to": "2026-01-31T23:59:59Z",
  "limit": 50
}

Response

OK

limitinteger

Page size applied for request

offsetinteger

Offset applied for request

total_responsesinteger

Total amount of elements matching requested filters

Example response

{
  "results": [
    {
      "failed_at": "2026-04-05T13:45:30Z",
      "id": 101,
      "reason": "Reason: Internal Server Error, body: service unavailable",
      "webhook": {
        "endpoint": "https://partner.example.com/webhooks",
        "event_type": "PUBLISH",
        "id": 20045
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.