pve_role_update
Update a Proxmox role's privileges with a dry-run preview. Append new privileges or replace existing ones, then confirm to apply changes.
Instructions
MUTATION: change a role's privileges. Dry-run by default — built-in roles (Administrator, PVEAdmin, …) are flagged HIGH (changing them re-scopes every ACL using them). confirm=True executes and returns a dict; synchronous, no UPID. Use pve_roles_list to see current roles and privileges first.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| privs | No | Comma-separated privilege names to set (or add, if append=True). | |
| append | No | If True, add `privs` to the role's existing privileges instead of replacing them. | |
| roleid | Yes | Role id to update. | |
| confirm | No | False (default) returns a dry-run PLAN preview; True executes the mutation. | |
| 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 |