Run Deployment

Updated at:

Manually triggers a single Deployment execution. The response returns a Deployment Run object that tracks the execution lifecycle.

Prerequisites

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

Endpoint

POST /deployments/{deployment_id}/run

Path parameters

FieldRequiredTypeDescription
deployment_idYesstringDeployment ID

Request example

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

Response

{
  "id": "drun_xxx",
  "type": "deployment_run",
  "deployment_id": "depl_xxx",
  "agent": {
    "id": "agent_xxx",
    "version": 13
  },
  "session_id": null,
  "trigger_source": "manual",
  "status": "running",
  "error": null,
  "started_at": "2026-07-28T02:00:00Z",
  "finished_at": null,
  "request_id": "req_xxx"
}

Response fields

FieldTypeDescription
idstringDeployment Run ID
typestringFixed value deployment_run
deployment_idstring—
agentobject—
session_idstring | nullnull until the asynchronous session creation completes
trigger_sourcestring—
statusstring—
errorobject | nullError information; returned only when the run fails
started_atstringISO 8601 timestamp
finished_atstring | null—
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_TRIGGER_CONFLICTConcurrent trigger conflict.