Deployments
Endpoints
Every deployment route at a glance.
All routes require Authorization and X-Workspace-Id headers, except
the health probe.
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/deployments/ | List deployments (paginated, filterable) |
| POST | /v1/deployments/ | Deploy a trained model |
| GET | /v1/deployments/{promotion_id} | Inspect one deployment |
| DELETE | /v1/deployments/{promotion_id} | Force-delete a deployment |
| POST | /v1/deployments/{promotion_id}/retry | Retry a failed deployment |
| GET | /v1/deployments/pipelines/{pipeline_id}/status | Promotion status for a pipeline |
| POST | /v1/deployments/pipelines/{pipeline_id}/unpromote | Remove a pipeline from serving |
| GET | /v1/deployments/serving | List everything currently serving |
| GET | /v1/deployments/shared/status | Shared serving status |
| GET | /v1/deployments/dedicated/status | Dedicated serving status |
| POST | /v1/deployments/dedicated/{deployment_id}/scale | Scale a Dedicated deployment |
| POST | /v1/deployments/cleanup | Clean up stale deployments |
| GET | /v1/deployments/health | Health probe for the deployments API (no auth) |