v
latestOpenAPI 3.1.02026-08-08139159197.8 KBInternal
Pre-deployment checks for a serving spec (platform admin)
Read-only. Evaluates everything that must already be true for a deployment with the given spec to admit, place, and register: the catalog row is seeded with pricing, the weights ref is published, the GPU footprint fits the serving capacity budget, prepared nodes exist, and readiness probing is configured. Each check is only applied when its query parameters are present, so the UI can preflight incrementally as a form is filled in.
get/v1/admin/inference/serving/preflight
Query parameters
publicModelIdstring
gpuModelIdstring
gpuCountPerReplicainteger
replicasDesiredinteger
weightsRefstring
nodePoolstring
The capacity lane this deployment would join, with publicModelId. Enables the rollout-peak capacity check.
rolloutRole'' | 'green'
Pass "green" to also evaluate the ROLLOUT peak: a rollout runs the old and new generations at once, so it needs the new footprint on top of what the lane already holds.
Response
Preflight result