clientapi-pmg 2026.5.24

Proxmox Mail Gateway API

clientapi_pmg

Python SDK for the Proxmox Mail Gateway API. Generated from the upstream apidoc.js from Proxmox Mail Gateway via openapi-generator-cli with custom Mustache template overrides.

Not an official Proxmox project. Community SDK derived from the upstream apidoc.js. Always verify against the upstream API viewer. https://pmg.proxmox.com/.

Requires Python ≥ 3.9.

Install

pip install clientapi-pmg

Or for development:

pip install -r requirements.txt

Usage

from clientapi_pmg import Configuration, Pve

cfg = Configuration(
    host='https://pmg1.example.com:8006/api2/json',
    api_key={'Authorization': 'PMGAPIToken=user@realm!tokenid=uuid-secret'},
)
pmg = Pmg(configuration=cfg)

# Per-tag properties are lazily instantiated and share the same ApiClient.
# `removeOperationIdPrefix=true` strips the tag prefix from method names,
# so the call is `pmg.qemu.vm_status(...)`, not `pmg.qemu.qemu_vm_status(...)` —
# you're already inside the `qemu` namespace.
status = pmg.qemu.vm_status(node='pmg1', vmid=100)
nodes = pmg.nodes.get_nodes()

Discovering available methods

Each per-tag API class lives at clientapi_pmg.api.<tag>_api.<Tag>Api. List its methods to see what's callable:

print([m for m in dir(pmg.qemu) if not m.startswith('_')])

Generated method-level docstrings explain parameters; the upstream endpoint reference is the upstream API viewer.

The unified Pmg class wraps each per-tag API class (QemuApi, LxcApi, ClusterApi, NodesApi, …) so consumers don't need to instantiate them individually.

Compound configs

PVE encodes many fields as CLI-style shorthand strings (net0=virtio,bridge=vmbr0,firewall=1). Round-trip helpers are emitted for every compound config schema:

from clientapi_pmg.models import PveQemuNetConfig

cfg = PveQemuNetConfig(model='virtio', bridge='vmbr0', firewall=1)
shorthand = cfg.to_shorthand()  # → 'virtio,bridge=vmbr0,firewall=1'

parsed = PveQemuNetConfig.from_shorthand(shorthand)

Indexed families

Numbered properties (net0..net31, mp0..mp255, …) are exposed on every model as a single collapsed nets / mps / … field:

req = QemuCreateVmRequest(
    nets={
        0: 'virtio,bridge=vmbr0',
        3: 'e1000,bridge=vmbr1',
    },
)
# Wire format: { 'net0': 'virtio,bridge=vmbr0', 'net3': 'e1000,bridge=vmbr1' }

License

Apache 2.0 — see LICENSE.