---
title: "Promote Deployment"
method: POST
path: "/agents/{agent_id}/deployments/{deployment_id}/promote"
tags: ["Deployments"]
---

# Promote Deployment

`POST /agents/{agent_id}/deployments/{deployment_id}/promote`

Promote a deployment to production with atomic cutover.

## Path parameters

- `deployment_id` string, required
- `agent_id` string, required

## Response `200`

Successful Response

- Deployment
  - `id` string, required — The unique identifier of the deployment.
  - `agent_id` string, required — The agent this deployment belongs to.
  - `docker_image` string, required — Full Docker image URI.
  - `registration_metadata` object, nullable — Git/build metadata from the agent pod.
  - `status` 'Pending' | 'Ready' | 'Failed', required
  - `acp_url` string, nullable — ACP URL set when agent registers.
  - `is_production` boolean, required — Whether this is the production deployment.
  - `sgp_deploy_id` string, nullable — Correlates to SGP's agentex_deploys.id.
  - `helm_release_name` string, nullable — Helm release name for cleanup.
  - `created_at` string, date-time, nullable — When the deployment was created.
  - `promoted_at` string, date-time, nullable — When promoted to production.
  - `expires_at` string, date-time, nullable — When marked for cleanup.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/scaleapi/apis/agentex-api.md) · [All operations](https://skmtc.dev/scaleapi/apis/agentex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scaleapi/agentex-api/revisions/1e0aaafd5780/schema)