API changes — night 2026-06-11
Synced read-only from
/home/synnet/mirrors/synvirt-product/docs/night/20260611/API-CHANGES.md. Edit at the source, not here.
API changes — night 2026-06-11
Section titled “API changes — night 2026-06-11”OpenAPI snapshot regenerated after every change (openapi.snapshot.json
- generated TS types ride the same commits). B = breaking, A = additive.
| # | Change | Kind | Consumers moved |
|---|---|---|---|
| 1 | PeerProbeView gains hostname |
A | Add-host flow reads it |
| 2 | POST /api/v1/hosts/add can now return 409 E_HOST_DUPLICATE_HOSTNAME |
A (new error) | ERROR_MAP copy added |
| 3 | HostNode gains cluster_id (additive, omitted when empty) |
A | inventory store groups N clusters |
| 4 | HostNode gains shared_datastores[] cells |
A | Cluster Health matrix |
| 5 | ClusterNode.clusters semantics: any number of cluster leaves (was 0..1) |
A (shape was already a list) | sidebar renders N |
| 6 | /api/v1/system/migration/* → /api/v1/system/live-motion/* |
B | zero consumers existed; spec + tags renamed |
| 7 | /api/v1/vswitches/{name}/vmkernels/{kind} → …/service-ports/{kind} |
B | UI client + its unit spec moved in the same commit |
| 8 | NEW /api/v1/storage/adapters (+ /iscsi/enable, /iscsi/discover, /iscsi/login, /iscsi/logout) |
A | Shared Storage view |
| 9 | NEW /api/v1/storage/devices |
A | Shared Storage view |
| 10 | NEW /api/v1/datastores/shared (GET/POST), …/{name} (DELETE), …/{name}/mount (POST) |
A | Shared Storage view + Guardian eligibility |
| 11 | NEW /api/v1/cluster/health |
A | Cluster Health card + tree dot |
| 12 | NEW /api/v1/cluster/services/{name} (GET/PUT) — guardian, smart_balance replicated configs |
A | Guardian panel |
| 13 | New error codes: E_HOST_DUPLICATE_HOSTNAME, E_ISCSI_*, E_DATASTORE_*, E_STORAGE_CMD_*, E_SERVICE_* |
A | ERROR_MAP curated for the hostname guard; storage/service codes surface daemon copy |
Replicated wire (cluster Raft log, postcard append-only): ClusterCommand
gains UpsertConfig / DeleteConfig at the END of the enum — old logs
replay unchanged; mixed-version clusters must not propose the new
variants until every member runs tonight’s build (the fleet deploys in
lockstep, and the only proposer of these variants is the new build).
Mesh proto: UNCHANGED (Guardian rides the existing
Federation.DefineVm + Federation.VmPower + inventory RPCs).