v52

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

Deployments

Promote Deployment

Promote a deployment to production with atomic cutover.

post/agents/{agent_id}/deployments/{deployment_id}/promote

deployment_idstring required

agent_idstring required

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.