v52

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

Deployments

Create Deployment

Create a new deployment record in PENDING status.

post/agents/{agent_id}/deployments

agent_idstring required

docker_imagestring required

Full Docker image URI.

registration_metadataobject nullable

Git/build metadata (commit_hash, branch_name, author_name, author_email, build_timestamp).

sgp_deploy_idstring nullable

SGP deployment ID.

helm_release_namestring nullable

Helm release name.

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.