pmg_spam_config_update
Update Proxmox Mail Gateway spam filter settings with dry-run planning and selective field changes. Reset specific fields to defaults or set new values for Bayesian, Razor, RBL checks, and more.
Instructions
MUTATION (MEDIUM): update PMG spam filter configuration. Dry-run by default. confirm=True to execute. Needs PROXIMO_PMG_* config.
Only non-None fields are sent — omitted fields keep their current PMG value; delete resets named fields to defaults, effective immediately on new inbound mail. Read current values with pmg_spam_config. Dry-run returns a PLAN; confirm=True executes and returns {"status": "ok", "result": ...}.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| delete | No | Comma-separated field names to reset to their PMG defaults. | |
| confirm | No | False (default) returns a dry-run PLAN; True executes the mutation. | |
| use_awl | No | Whether to enable the auto-whitelist; omit to leave unchanged. | |
| languages | No | Space-separated language codes used for spam language-based scoring; omit to leave unchanged. | |
| use_bayes | No | Whether to enable Bayesian spam classification; omit to leave unchanged. | |
| use_razor | No | Whether to enable Razor collaborative spam filtering; omit to leave unchanged. | |
| rbl_checks | No | Whether to enable RBL (realtime blocklist) checks; omit to leave unchanged. | |
| maxspamsize | No | Maximum message size in bytes scanned for spam; omit to leave unchanged. | |
| bounce_score | No | Spam score threshold added for bounce/NDR-shaped messages; omit to leave unchanged. | |
| extract_text | No | Whether to extract text from attachments for spam scanning; omit to leave unchanged. | |
| 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. | |
| wl_bounce_relays | No | Whitelisted bounce-relay hosts, space-separated; omit to leave unchanged. | |
| clamav_heuristic_score | No | Spam score added when ClamAV heuristic detection fires; omit to leave unchanged. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |