postfix_queue_list
Read-only
List queued Postfix messages with queue ID, arrival time, size, sender, recipients, and delay reasons. Filter by queue, recipient domain, sender, reason category/text, or minimum age.
Instructions
List queued messages (queue ID, queue, arrival time, size, sender, recipients with delay reasons), filtered by queue, recipient domain, sender, reason text, reason category or minimum age.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | max messages returned (default 50) | |
| queue | No | queue name filter, e.g. deferred | |
| domain | No | recipient domain; a leading dot matches subdomains too | |
| sender | No | substring of the envelope sender | |
| min_age | No | only messages older than this, e.g. 2h or 3d | |
| category | No | reason category id, e.g. rate_limit, auth, ptr, timeout | |
| reason_contains | No | case-insensitive substring of the delay reason |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| matched | Yes | ||
| messages | Yes | ||
| returned | Yes |