Get Deployment Run
Updated at:
Retrieves the details of a single Deployment Run by ID.
Prerequisites
Endpoint and authentication configured. For details, see API overview and authentication.
Endpoint
GET /deployment_runs/{deployment_run_id}
Path parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
deployment_run_id | Yes | string | Deployment Run ID |
Request example
curl "$AGENTSTUDIO_URL/deployment_runs/drun_xxx" \
-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": "sesn_xxx",
"trigger_source": "manual",
"status": "succeeded",
"error": null,
"started_at": "2026-07-28T02:00:00Z",
"finished_at": "2026-07-28T02:03:00Z",
"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 | — |
trigger_source | string | — |
status | string | — |
error | object | null | Error info; 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. |
| 404 | DEPLOYMENT_RUN_NOT_FOUND | Deployment run not found. |
Is this page helpful?