Skip to main content
GET
Get a deployment

Authorizations

X-API-Key
string
header
required

Organization API key

Path Parameters

deployment_id
string
required

Response

Successful Response

A model deployment’s lifecycle, serving configuration, and endpoint details.

deployment_id
string
required

Unique identifier of the deployment.

test_model_slug
string
required

Exact test model slug owned by this deployment.

model_slug_id
string
required

ID of this deployment test model slug row.

status
enum<string>
required

Deployment lifecycle state.

Available options:
PENDING,
DEPLOYING,
DEPLOYED,
FAILED,
CANCELLING,
CANCELLED
role
enum<string>
required

Whether this is the production or a test deployment.

Available options:
production,
test
is_active
boolean
required

True when this deployment currently answers for the slug.

checkpoint_id
string
required

Trajectory checkpoint selected when the deployment was created.

base_model_slug
string
required

Base model used for the checkpoint, when available.

checkpoint_step
integer
required

Training step of the source checkpoint.

created_at
string<date-time>
required

When the deployment was requested.

agent_id
string | null

Owning agent; null for unassigned legacy deployments.

production_model_slug
string | null

The owning agent production model slug; null until configured.

agent_name
string | null

Owning agent display name; null for a deleted agent.

model_endpoint_id
string | null

Model Endpoint serving this deployment.

created_by
string | null

Email of the user who requested this deployment.

completed_at
string<date-time> | null

When the deployment first became DEPLOYED; unlike updated_at, later promote/demote transitions never overwrite this.

updated_at
string<date-time> | null

Last lifecycle transition; null until the row first moves.

failure
AsyncFailure · object | null

Structured failure when status is FAILED.