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

ParameterRequiredTypeDescription
deployment_run_idYesstringDeployment 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

FieldTypeDescription
idstringDeployment Run ID
typestringFixed value deployment_run
deployment_idstring—
agentobject—
session_idstring | null—
trigger_sourcestring—
statusstring—
errorobject | nullError info; 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.
404DEPLOYMENT_RUN_NOT_FOUNDDeployment run not found.