Skip to main content

​
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.

​
omni dead-letters list

List dead letters with optional filters. 
omni dead-letters list [options]

​
omni dead-letters get

Get dead letter details. 
omni dead-letters get <id>

​
omni dead-letters stats

Get dead letter statistics. 
omni dead-letters stats

​
omni dead-letters retry

Retry processing a failed event. 
omni dead-letters retry <id>

​
omni dead-letters resolve

Mark a dead letter as resolved (acknowledged, no retry needed). 
omni dead-letters resolve [options] <id>

​
omni dead-letters abandon

Abandon a dead letter — stop all retry attempts. 
omni dead-letters abandon <id>

# List recent failures
omni dead-letters list

# Check failure stats
omni dead-letters stats

# Retry a specific event
omni dead-letters retry dl-abc123

# Mark as resolved (no retry)
omni dead-letters resolve dl-abc123

​
Payloads

Inspect event payloads at different processing stages.

​
omni payloads list

List payloads for an event. 
omni payloads list <eventId>

​
omni payloads get

Get a specific payload stage. 
omni payloads get <eventId> <stage>
Stages: webhook_raw, agent_request, agent_response, channel_send, error.

​
omni payloads delete

Delete payloads for an event. 
omni payloads delete [options] <eventId>

​
omni payloads config

List or update payload storage configuration. 
omni payloads config [options] [eventType]

​
omni payloads stats

Get payload storage statistics. 
omni payloads stats

# Inspect all payload stages for an event
omni payloads list evt-abc123

# Get the raw webhook payload
omni payloads get evt-abc123 webhook_raw

# Check storage stats
omni payloads stats