pbs_notification_endpoint_update
Modify a Proxmox Backup Server notification endpoint (gotify, sendmail, smtp, webhook). Dry-run captures current config; confirm executes the update with optimistic locking.
Instructions
MUTATION: update a PBS notification endpoint. ep_type = gotify|sendmail|smtp|webhook. Dry-run by default — captures current config into the PLAN (secrets masked); confirm=True executes (PUT .../endpoints/{type}/{name}, synchronous — PBS returns null) and returns {"status": "ok", "result": None}. No snapshot primitive; re-apply the captured config to revert, or use pbs_notification_endpoint_create to make a new one instead. Needs PROXIMO_PBS_* config.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the existing notification endpoint to update. | |
| digest | No | Optimistic-lock: 64-char lowercase hex SHA-256 of the config PBS last returned. If set and stale, PBS rejects the update. | |
| comment | No | Optional free-text comment to set on the endpoint. | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the update. | |
| disable | No | True disables the endpoint; False re-enables it. | |
| ep_type | Yes | Notification endpoint type: 'gotify', 'sendmail', 'smtp', or 'webhook'. | |
| options | No | Type-specific fields to change, same shape as create. Credential-shaped keys (token/password/secret/header) are redacted from the PLAN preview and the audit ledger, but ARE sent to PBS on confirm=True. | |
| 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 |