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
| Field | Required | Type | Description |
|---|---|---|---|
deployment_id | Yes | string | Deployment 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
| Field | Type | Description |
|---|---|---|
id | string | Deployment Run ID |
type | string | Fixed value deployment_run |
deployment_id | string | — |
agent | object | — |
session_id | string | null | null until the asynchronous session creation completes |
trigger_source | string | — |
status | string | — |
error | object | null | Error information; returned only when the run fails |
started_at | string | ISO 8601 timestamp |
finished_at | string | null | — |
request_id | string | Unique identifier of this request; include it when troubleshooting |
Error codes
| HTTP status | Error code | Description |
|---|---|---|
| 400 | InvalidParameter | Required parameter missing or invalid. |
| 401 | InvalidApiKey | Invalid API-key provided. |
| 409 | DEPLOYMENT_TRIGGER_CONFLICT | Concurrent trigger conflict. |
Is this page helpful?