pmg_tasks_list
List tasks on a Proxmox Mail Gateway node, with filters for errors, time range, task type, user, and status.
Instructions
READ-ONLY: list PMG tasks on a node. Needs PROXIMO_PMG_* config.
Returns a list of task dicts. errors=True returns only failed tasks. For a PVE hypervisor node's tasks use pve_tasks_list instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | PMG node name; defaults to the configured node. | |
| limit | No | Maximum tasks to return. | |
| since | No | Unix epoch: only tasks started at or after this time. | |
| start | No | Pagination offset into the task list. | |
| until | No | Unix epoch: only tasks started at or before this time. | |
| errors | No | If True, return only failed tasks. | |
| typefilter | No | Filter tasks by task type. | |
| userfilter | No | Filter tasks by the user that started them. | |
| statusfilter | No | Filter tasks by status text. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |