Sign in

v3

OpenAPI 3.1.0MIT2026-07-31192456807.8 KB
Deployments

Get a deployment by ID or name

Retrieve details of a specific deployment by its ID or name

get/deployments/{id}

Path parameters

idstring required

Deployment ID or name

Response

Deployment details

argsstring[]

Args are the arguments passed to the container's command

commandstring[]

Command is the entrypoint command run in the container

cpunumber

CPU is the amount of CPU resource allocated to each replica in cores (fractional value is allowed)

created_atstring date-time

CreatedAt is the ISO8601 timestamp when this deployment was created

descriptionstring

Description provides a human-readable explanation of the deployment's purpose or content

desired_replicasinteger

DesiredReplicas is the number of replicas that the orchestrator is targeting

gpu_countinteger

GPUCount is the number of GPUs allocated to each replica in this deployment

gpu_type'h100-80gb' | 'h100-40gb-mig' | 'h200-140gb' | 'b200-192gb'

GPUType specifies the type of GPU requested (if any) for this deployment

health_check_pathstring

HealthCheckPath is the HTTP path used for health checks of the application

idstring

ID is the unique identifier of the deployment

imagestring

Image specifies the container image used for this deployment

max_replicasinteger

MaxReplicas is the maximum number of replicas to run for this deployment

memorynumber

Memory is the amount of memory allocated to each replica in GiB (fractional value is allowed)

min_replicasinteger

MinReplicas is the minimum number of replicas to run for this deployment

namestring

Name is the name of the deployment

object'deployment'

The object type, which is always deployment.

portinteger

Port is the container port that the deployment exposes

ready_replicasinteger

ReadyReplicas is the current number of replicas that are in the Ready state

replica_eventsobject

ReplicaEvents is a mapping of replica names or IDs to their status events

status'Updating' | 'Scaling' | 'Ready' | 'Failed' | 'ScaledToZero'
storageinteger

Storage is the amount of storage (in MB or units as defined by the platform) allocated to each replica

termination_grace_period_secondsinteger

TerminationGracePeriodSeconds is the time in seconds to wait for graceful shutdown before forcefully terminating the replica

updated_atstring date-time

UpdatedAt is the ISO8601 timestamp when this deployment was last updated

Example response

{
  "autoscaling": {
    "metric": "HTTPTotalRequests",
    "target": 100,
    "time_interval_minutes": 10
  }
}