SCscaleapi
Deployments

Create Deployment

Create a new deployment record in PENDING status.

post/agents/{agent_id}/deployments

Request

  • The document declares no server URL.
  • Auth
    none declared

Path parameters

agent_idstring required

Request body

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.

Response

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.

Changes

No recorded changes to this operation across all 58 revisions of this API.