pve_tasks_list
List recent tasks on a Proxmox node. Filter by VMID, task type, status, or only errors. Returns up to 1000 results.
Instructions
READ-ONLY: list recent tasks on a node. limit max 1000 (higher is truncated; 0 or negative is rejected). No state change; returns a list of task dicts. Use pve_task_log for a task's full log.
Caveat: this is a windowed, per-node slice — node defaults to the configured node, and
only the limit most-recent tasks return. A task on another node or outside the window
is absent without being dead. Never conclude a backup failed from absence here — verify
against pve_backup_list or pbs_snapshots_list.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Node to list tasks from; defaults to the configured node. | |
| vmid | No | Optional VMID/CTID to filter tasks to a single guest. | |
| limit | No | Max number of most-recent tasks to return, max 1000 (0 or negative is rejected). | |
| errors | No | If True, only return tasks that ended in error. | |
| typefilter | No | Optional task-type filter, e.g. 'vzdump', 'qmigrate' (PVE task type string). | |
| statusfilter | No | Optional status filter, e.g. 'running', 'stopped'. | |
| 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 |