# proxbox-api v0.0.11

proxbox-api v0.0.11

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/proxbox-api/releases/v0.0.11 |
| GitHub URL | https://github.com/emersonfelipesp/proxbox-api/releases/tag/v0.0.11 |
| Tag | v0.0.11 |
| State | latest |
| Author | emersonfelipesp |
| Created | 2026-05-15 14:08 UTC |
| Published | 2026-05-15 17:17 UTC |
| Target | main |
| Synced | 2026-05-15 19:24 UTC |
| Assets | 0 |

## Release notes

## proxbox-api v0.0.11

This production release is the backend/API half of the Proxbox release train paired with `netbox-proxbox v0.0.15`. It was validated against NetBox `v4.5.8`, `v4.5.9`, and `v4.6.0`, and publishes both the Python package and Docker image variants used by the plugin.

### Highlights

- Adds HA cluster read APIs for the NetBox Proxbox HA tab and cluster page.
- Adds opt-in Proxmox operational verb routes for start, stop, snapshot, and migrate, guarded by endpoint write permissions.
- Adds cloud-init and cloud provisioning support, including `/cloud/vm/provision` and `/cloud/templates`.
- Adds NetBox Branching support by forwarding `X-NetBox-Branch` through full and individual sync flows.
- Adds idempotent NetBox bootstrap, drift-detecting writes, run stamps, orphan sweep support, duplicate-name resolution, discovery tags, and sync-active probing.
- Improves VM sync fidelity: primary MAC writes through `dcim.mac_addresses`, IPv6 link-local filtering, Proxmox tag sync, description metadata parsing, cloud-init reflection, endpoint placement, and role preservation.
- Adds hardware discovery support through netbox-proxbox credentials, plus Ceph and read-only PBS route surfaces.
- Improves PVE 9 authentication diagnostics and closes abandoned SDK sessions.
- Improves Docker/CI release reliability across raw, nginx, and granian image variants.

### Compatibility

- Python: `>=3.11`
- NetBox validation matrix: `v4.5.8`, `v4.5.9`, `v4.6.0`
- Required companion plugin: `netbox-proxbox >= 0.0.15`
- SDK pins: `proxmox-sdk==0.0.4.post3`, `netbox-sdk==0.0.8.post1`

### Closed Issues

- [proxbox-api#61](https://github.com/emersonfelipesp/proxbox-api/issues/61) - `settings_client` now honors `ssl_verify=false`.
- [netbox-proxbox#352](https://github.com/emersonfelipesp/netbox-proxbox/issues/352) - fixed FastAPI setup failures when using the nginx Docker container.
- [netbox-proxbox#357](https://github.com/emersonfelipesp/netbox-proxbox/issues/357) - added drift-detecting writes with a `createOrUpdate` helper.
- [netbox-proxbox#358](https://github.com/emersonfelipesp/netbox-proxbox/issues/358) - made NetBox-side supporting object bootstrap idempotent.
- [netbox-proxbox#359](https://github.com/emersonfelipesp/netbox-proxbox/issues/359) - migrated/verified primary MAC linkage through `dcim.mac_addresses`.
- [netbox-proxbox#361](https://github.com/emersonfelipesp/netbox-proxbox/issues/361) - skips IPv6 link-local addresses and strips zone IDs during IP reconciliation.
- [netbox-proxbox#362](https://github.com/emersonfelipesp/netbox-proxbox/issues/362) - added Proxmox discovery tag patterns for VMs and LXCs.
- [netbox-proxbox#363](https://github.com/emersonfelipesp/netbox-proxbox/issues/363) - added read-side cloud-init reflection fields.
- [netbox-proxbox#364](https://github.com/emersonfelipesp/netbox-proxbox/issues/364) - added role pinning by VM type.
- [netbox-proxbox#365](https://github.com/emersonfelipesp/netbox-proxbox/issues/365) - added tenant assignment by VM-name regex.
- [netbox-proxbox#366](https://github.com/emersonfelipesp/netbox-proxbox/issues/366) - added description metadata parsing and overwrite controls.
- [netbox-proxbox#367](https://github.com/emersonfelipesp/netbox-proxbox/issues/367) - added latest job UUID stamping and orphan deletion support.
- [netbox-proxbox#368](https://github.com/emersonfelipesp/netbox-proxbox/issues/368) - resolves duplicate VM names and emits duplicate-name SSE frames.
- [netbox-proxbox#370](https://github.com/emersonfelipesp/netbox-proxbox/issues/370) - added optional NetBox Branching support.
- [netbox-proxbox#372](https://github.com/emersonfelipesp/netbox-proxbox/issues/372) - added scheduler container mode support.
- [netbox-proxbox#374](https://github.com/emersonfelipesp/netbox-proxbox/issues/374) - added hardware discovery via SSH, `dmidecode`, and `ethtool`.
- [netbox-proxbox#375](https://github.com/emersonfelipesp/netbox-proxbox/issues/375) - introduced the backend session refactor foundation.
- [netbox-proxbox#376](https://github.com/emersonfelipesp/netbox-proxbox/issues/376) - added strictly opt-in operational REST endpoints.
- [netbox-proxbox#390](https://github.com/emersonfelipesp/netbox-proxbox/issues/390) - fixed tenant/site definition handling.
- [netbox-proxbox#391](https://github.com/emersonfelipesp/netbox-proxbox/issues/391) - fixed Proxbox VM/LXC object links for NetBox `v4.5.9`.
- [netbox-proxbox#406](https://github.com/emersonfelipesp/netbox-proxbox/issues/406) - ported Branching and SyncContext support into this release train.
- [netbox-proxbox#417](https://github.com/emersonfelipesp/netbox-proxbox/issues/417) - improved Proxmox VE 9 connection/authentication handling.
- [netbox-proxbox#421](https://github.com/emersonfelipesp/netbox-proxbox/issues/421) - syncs Proxmox tags into NetBox tags.
- [N-MultiCloud/nms#12](https://github.com/N-MultiCloud/nms/issues/12) - supports cloud-init workflows used by the NMS surface.

### Verification

- `v0.0.11rc8` completed the full release lane across PyPI, Docker Hub, and post-publish E2E.
- PR #108 completed green on the final release commit.
- Main merge commit `c3641ab` completed docs and CI successfully.
- Tag validation run `25923332054` completed green for `v0.0.11`.
- Production release run `25931295148` completed green:
  - PyPI publish completed at `2026-05-15T18:59:33Z`.
  - PyPI install validation passed on Python `3.11`, `3.12`, and `3.13`.
  - Docker Hub publish passed for raw, nginx, and granian image variants.
  - Post-publish E2E passed against NetBox `v4.5.8`, `v4.5.9`, and `v4.6.0`.
- Release Docker verification run `25931295149` completed green after the images were published.

## Assets

No binary assets attached.

Source archives:

| Format |URL |
| --- | --- |
| zip | https://api.github.com/repos/emersonfelipesp/proxbox-api/zipball/v0.0.11 |
| tar.gz | https://api.github.com/repos/emersonfelipesp/proxbox-api/tarball/v0.0.11 |
