v52

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0189112274.5 KB

Deployments

List Deployments

List deployments for an agent, newest first.

get/agents/{agent_id}/deployments

agent_idstring required

limitinteger

Limit

page_numberinteger

Page number

order_bystring nullable

Field to order by

order_directionstring

Order direction (asc or desc)

Successful Response

idstring required

The unique identifier of the deployment.

agent_idstring required

The agent this deployment belongs to.

docker_imagestring required

Full Docker image URI.

registration_metadataobject nullable

Git/build metadata from the agent pod.

status'Pending' | 'Ready' | 'Failed' required

acp_urlstring nullable

ACP URL set when agent registers.

is_productionboolean required

Whether this is the production deployment.

sgp_deploy_idstring nullable

Correlates to SGP's agentex_deploys.id.

helm_release_namestring nullable

Helm release name for cleanup.

created_atstring date-time nullable

When the deployment was created.

promoted_atstring date-time nullable

When promoted to production.

expires_atstring date-time nullable

When marked for cleanup.