Listar observações de dead-letter
Análise forense de operador entre tenants (cross-tenant): retorna uma página, paginada por keyset e em ordem cronológica inversa, de observações de dead-letter capturadas do pipeline de entrega. Esta é uma superfície de operador — ela autoriza contra um escopo de operador e não carrega contexto de tenant. A projeção não carrega segredo, nem URL de endpoint do cliente, nem material de assinatura. O campo tenant_id_raw é uma captura não confiável e de melhor esforço, exposta apenas por valor forense.
Autorizações
Um JWT bearer emitido pelo plugin-auth (lib-auth). A identidade do tenant é resolvida a partir das claims validadas do token; a superfície /v1 nunca lê um tenant do corpo, do path ou da query. Chamadores de máquina obtêm um token via o fluxo client-credentials do plugin-auth. A superfície /admin autoriza contra um escopo de operador e não carrega contexto de tenant.
Parâmetros de consulta
Optional filter on the source topic the failed delivery originated from.
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.
serialization, validation, auth, topic_not_found, broker_unavailable, network_timeout, broker_overloaded, context_canceled, unknown Keyset cursor — the id (UUIDv7) of the last row from the previous page. A malformed value returns 400 invalid_cursor.
Resposta
Uma página de observações de dead-letter.

