Skip to main content
GET
List dead-letter observations

Authorizations

Authorization
string
header
required

A bearer JWT issued by plugin-auth (lib-auth). The tenant identity is resolved from the validated token claims; the /v1 surface never reads a tenant from the body, path, or query. Machine callers obtain a token via the plugin-auth client-credentials flow. The /admin surface authorizes against an operator scope and carries no tenant context.

Query Parameters

source_topic
string

Optional filter on the source topic the failed delivery originated from.

error_class
enum<string>

Optional filter on the transport error class. An unrecognized value returns 400 invalid_error_class. The transport error class a dead-letter observation may be filtered on.

Available options:
serialization,
validation,
auth,
topic_not_found,
broker_unavailable,
network_timeout,
broker_overloaded,
context_canceled,
unknown
after
string<uuid>

Keyset cursor — the id (UUIDv7) of the last row from the previous page. A malformed value returns 400 invalid_cursor.

Response

A page of dead-letter observations.

observations
object[]
required

A page of dead-letter observations, reverse-chronological.

nextCursor
string
required

Keyset cursor for the next (older) page — the id of the last row. Empty when there are no further pages.

Example:

"0192f1a0-0000-7000-8000-00000000d017"