2.4.1 API changelogs

Registered routes (main.go)

526 → 546

Documented operations (Swagger)

499 → 550

Genuinely new endpoints (live routes)

20

Newly documented endpoints (already live in 2.4.0)

~38

Removed endpoints (live routes)

0

Removed from Swagger only (doc cleanup, never routed / renamed)

7

Breaking changes (wire contract)

1

New schemas / DTOs

51

Renamed schemas / DTOs (package move, identical fields)

14

Removed schemas / DTOs (stale, never routed)

2

Enriched schemas / DTOs

~19

GPUaaS node DTOs
models.AddNodeGpuaasOpts (request)
models.NodeGpuaasResp, models.GPUaaSNodeDetails (responses)

rootfs_persistence_capableremoved from these node-level DTOs. RootFS capability is now surfaced at the pool level (models.GPUaaSPool.rootfs_persistence_capable) and is auto-derived from whether the region has an is_storage_service node (ref MHA-673). Setting it per-node on add is no longer honoured; reading it from a node response returns nothing.

Read RootFS capability from the pool object (GPUaaSPool.rootfs_persistence_capable) instead of from node responses. Stop sending it in the node-add payload.

Node-level rootfs_persistence_capable

DEPRECATED Already removed from the node DTOs in 2.4.1 (see §2); the concept now lives only at pool level.

Consume pool-level capability only.

Marketplace linking via plaintext token — POST /api/marketplace/link

LEGACY The code marks this the “legacy paste-token” link path. The OAuth authorize flow (GET /api/marketplace/authorize + /authorize/login + /authorize/submit, plus GET /api/marketplace/oauth-info) is the modern linking mechanism.

New integrations should link via the OAuth authorize flow rather than posting a plaintext token.

Package-prefixed Swagger schema names (e.g. models.X)

CHANGING Schema definitions are being progressively moved from the models package into domain packages (e.g. types.*). 14 definitions were renamed this way in 2.4.1; more are expected in upcoming releases. The JSON wire format is unchanged; only the generated schema names change.

Clients that generate SDKs from the OpenAPI spec should expect model class-name churn and plan to regenerate. Consider pinning names via a model-name mapping.

GET

/api/gpuaas/floating-ip/list

ListFloatingIPMappings

Secure

List floating-IP mappings

GET

/api/gpuaas/floating-ip/available-ips

GetAvailableIPs

Secure

List available IPs for mapping

POST

/api/gpuaas/floating-ip/create

CreateFloatingIPMapping

Secure

Create a floating-IP mapping

PUT

/api/gpuaas/floating-ip/{id}/edit

UpdateFloatingIPMapping

Secure

Update a mapping

DELETE

/api/gpuaas/floating-ip/{id}/delete

DeleteFloatingIPMapping

Secure

Delete a mapping

GET

/api/kvm/region/{region_id}/ha/status

GetKVMHAStatus

default

Get HA status for a KVM region

POST

/api/kvm/region/{region_id}/ha/enable

EnableKVMHA

default

Enable HA for a KVM region

POST

/api/kvm/region/{region_id}/ha/disable

DisableKVMHA

default

Disable HA for a KVM region

POST

/api/kvm/node/{id}/force_remove

ForceRemoveKVMClusterNode

default

Force-remove a KVM cluster node

GET

/api/marketplace/pods/rootfs-status

MarketplacePodRootfsStatus

MarketplaceGate

RootFS extraction status for a marketplace pod

POST

/api/marketplace/pods/rootfs

MarketplacePodRootfs

MarketplaceGate

RootFS action on a marketplace pod

POST

/api/marketplace/pods/factory_reset

MarketplacePodFactoryReset

MarketplaceGate

Factory-reset a marketplace pod

GET

/api/marketplace/recon/inventory

GetReconInventory

MarketplaceGate

Reconciliation inventory of published pools/workers

POST

/api/pod-instances/sync

SyncPodInstances

default

Sync pod-instance state

DELETE

/api/pod-instances/{worker_id}

DeletePodInstance

default

Delete a pod instance by worker ID

POST

/api/teams/sync

SyncTeams

default

Sync teams

GET

/api/gpuaas/nodes/storage/available

GpuaasNodesGetStorageAvailability

default

Available storage across GPUaaS nodes

GET

/api/regions/{region_id}/storage

GetRegionStorageDetail

default

Storage detail for a region

GET

/api/recipes/execution-logs

GetRecipeExecutionLogs

default

Admin recipe execution logs

GET

/api/get-last-10-min-stats

GetLast10MinStats

default

Instant stats for the last 10 minutes

GET /clusters/{cl_id}/pci_devs

Path corrected to match the live route GET /clusters/{cl_id}/pcidevs.

GET /gpuaas-npu

Path corrected to match the live route GET /gpuaas-npu/all.

GET /marketplace/status
GET /pools

Stale Swagger entries — never registered as live routes in either branch.

POST /marketplace/connect
POST /marketplace/sync
POST /marketplace/disconnect

Documented-but-not-routed in 2.4.0 (flagged as a doc gap in the previous changelog); Swagger definitions now removed. DTOs ctrls.marketplaceConnectRequest and ctrls.marketplacePool removed with them.

db.Region

+ kvmClusterEnabled

models.Region

+ active_nodes, kvm_cluster_enabled, local_storage_utilization_percent, shared_storage_utilization_percent

models.CreateRegionReq

+ kvm_cluster_enabled

models.Status

+ kvm_cluster

models.GPUaaSPool

+ marketplace_active_deployments, marketplace_max_deployments, rootfs_persistence_capable, scheduler_mode, vip_ratio

models.GPUaaSNodeDetails, models.NodeGpuaasResp

+ active_instance_count, local_storage_allocated_percentage, os_type, shared_storage_allocated_percentage; − rootfs_persistence_capable (see §2)

models.AddNodeGpuaasOpts

− rootfs_persistence_capable (see §2)

models.ProvisionPodOpts

+ fractional_shares, guaranteed_gpu_share_percent, instance_name, is_vip_priority, marketplace_subscription_id, rootfs_enabled

models.MarketplacePodProvisionRequest

+ instance_name, marketplace_subscription_id, rootfs_enabled

models.MarketplacePodDetail

+ rootfs_status

models.MarketplacePoolResponse, models.MarketplacePoolDetailResponse

+ rootfs_persistence_capable

models.ProvisionMarketplacePoolRequest

+ max_marketplace_deployments, rootfs_persistence_capable

models.BaremetalSubscriptionResp

+ ssh_keys, ssh_password

models.SubscribeToBaremetalPayload

+ ssh_keys

models.WorkerSSHInfo

+ rootfs_status

models.Role

permissions retyped []models.PermissionRole → []types.PermissionRole (package rename — see §7.3)

models.VDisk

actions retyped []models.VDiskAction → []types.VDiskAction (package rename — see §7.3)