Unpause Deployment

Updated at:

Resumes a paused Deployment to active status. Scheduled triggers resume according to the configured cron expression.

Prerequisites

Endpoint and authentication configured. For details, see API overview and authentication.

Endpoint

POST /deployments/{deployment_id}/unpause

Path parameters

ParameterRequiredTypeDescription
deployment_idYesstringDeployment ID

Request example

curl -X POST "$AGENTSTUDIO_URL/deployments/depl_xxx/unpause" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response

{
  "id": "depl_xxx",
  "type": "deployment",
  "name": "Daily Report Generator",
  "description": "Generates daily sales reports",
  "agent": {
    "id": "agent_xxx",
    "version": 13
  },
  "environment_id": "env_xxx",
  "schedule": {
    "cron": "0 9 * * *"
  },
  "initial_events": [],
  "resources": [],
  "vault_ids": [],
  "metadata": {},
  "status": "active",
  "paused_reason": null,
  "archived_at": null,
  "created_at": "2026-07-20T10:00:00Z",
  "updated_at": "2026-07-28T02:00:00Z",
  "request_id": "req_xxx"
}

Response fields

FieldTypeDescription
idstringDeployment ID
typestringFixed value deployment
namestringDeployment name
descriptionstringDeployment description
agentobject—
environment_idstring—
scheduleobjectScheduled trigger configuration
initial_eventsarray<object>—
resourcesarray<object>—
vault_idsarray<string>—
metadataobject—
statusstring—
paused_reasonstring | null—
archived_atstring | null—
created_atstring—
updated_atstring—
request_idstringUnique identifier of this request; include it when troubleshooting

Error codes

HTTP statusError codeDescription
400InvalidParameterRequired parameter missing or invalid.
401InvalidApiKeyInvalid API-key provided.
409DEPLOYMENT_STATE_CONFLICTCannot unpause an archived deployment.