Debug & Operations Commands
These commands are hidden by default and visible with the--all flag. They are used for troubleshooting and operations.
Dead Letters
Manage failed events that could not be processed. Dead letters capture events that exhausted their retry budget — typically webhook deliveries, agent callbacks, or channel sends that repeatedly errored.When to use: if a message appears stuck (received on the channel but never processed, or an outbound reply that never arrived), start with
omni dead-letters list to see if the event landed in the dead-letter queue. Use stats for an aggregate health check, get to inspect the failure, and retry once the underlying issue is resolved. The dead-letters command is hidden from default omni --help — it is visible via omni --all and intended for operators and debugging.omni dead-letters list
List dead letters with optional filters.
omni dead-letters get
Get dead letter details.
omni dead-letters stats
Get dead letter statistics.
omni dead-letters retry
Retry processing a failed event.
omni dead-letters resolve
Mark a dead letter as resolved (acknowledged, no retry needed).
omni dead-letters abandon
Abandon a dead letter — stop all retry attempts.
Payloads
Inspect event payloads at different processing stages.omni payloads list
List payloads for an event.
omni payloads get
Get a specific payload stage.
webhook_raw, agent_request, agent_response, channel_send, error.