Skip to content

PGMQ_DEAD_LETTER_KEY

const PGMQ_DEAD_LETTER_KEY: "__pgxsinkitDeadLetter" = "__pgxsinkitDeadLetter"

Defined in: packages/server/src/events/pgmq-queue.ts:51

The reserved key the dead-letter reason is stamped under, INSIDE the archived message body.

Least surface, deliberately: pgmq’s archive is the dead-letter storage (no library-owned DLQ table), the archive row has no free column to carry a reason, and its headers column only exists on newer pgmq versions. So the reason rides one reserved key on the ARCHIVED body — the live queue row is never mutated, a normally-consumed message is byte-identical to what was enqueued, and the key is stripped again by EventQueue.listDeadLetters / EventQueue.requeueDeadLetter so a requeued message is exactly the message that was enqueued.