Skip to content
Weik.ioDocs
2026.2
Try Weik.io

A reader has dead letters

Weik.io 2026.2

A reader has events it couldn't handle after its last retry. To see each one with the reason it failed, run weikio deadletters list. Video

Watch: Dead letters, 3:23

The video follows a failed event into the dead letters and sends it to its reader again with weikio deadletters resend.

On this page
Kind Severity Who sees it
reader-dead-letters Warning Everyone who can read the deployment

What it means#

A reader has events it couldn’t handle after its last retry. Weik.io keeps each one as a dead letter with the reason it failed.

What raises it#

The reader has at least one dead letter.

What to check#

List the reader’s dead letters:

Terminal
$ weikio deadletters list --env <environment> --integration <project>/<integration>

Print one with its event and the reason it failed:

Terminal
$ weikio deadletters show --env <environment> --seq <seq>

How to fix it#

Fix the cause, such as a route bug or a system that refused the event, then send the dead letters again to the integration they failed in:

Terminal
$ weikio deadletters resend --env <environment> --integration <project>/<integration> --all

Discard the ones that shouldn’t be handled. The problem clears when the reader has no dead letters.

Sign in to the live demo

Sign in with the shared viewer account. It can open every screen of the example projects but can't change anything.

E-mail
viewer@demo.weik.io
Password
try-weikio-live-demo
Open the live demo