Skip to main content
POST /v1/deployments/{id}/run Manually triggers a deployment run. The deployment must be in active status (not paused or archived). If the maximum concurrent run limit is reached, the run is recorded with skipped status.

​
Path parameters

ParameterTypeDescription
idstringDeployment ID with the dep_ prefix

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT
Content-TypeYesapplication/json

​
Request body

No request body is required. Send an empty JSON object {} or omit the body.

​
Example request

curl -X POST "https://api.qoder.com/api/v1/cloud/deployments/dep_019ec556114c78f8b60ee34fcb98bf59/run" \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json"

​
Example response

HTTP 200 OK Returns a Deployment Run object. 
{
  "agent": {
    "id": "agent_019eb4d4a06d747c865d5800b9c57ae2",
    "type": "agent",
    "version": 1
  },
  "cas_run_extras": {
    "attempt": 1,
    "started_at": "2026-06-14T08:54:06.310253147Z",
    "turn_id": "turn_019ec55694cb76249bc9ba56bf13a15c"
  },
  "created_at": "2026-06-14T08:54:06.271902633Z",
  "deployment_id": "dep_019ec556114c78f8b60ee34fcb98bf59",
  "error": null,
  "id": "drun_019ec55694c07f2a9b402ffb4448ec18",
  "session_id": "sess_019ec55694c47605a8904c8f3d842ccb",
  "status": "running",
  "trigger_context": {
    "type": "manual"
  },
  "triggered_at": "2026-06-14T08:54:06.271902633Z",
  "type": "deployment_run"
}

​
Response fields (Deployment Run)

FieldTypeDescription
idstringRun unique identifier (drun_ prefix)
typestringAlways "deployment_run"
deployment_idstringParent Deployment ID
agentobjectAgent reference: {id, type, version}
statusstringRun status: pending, running, completed, failed, skipped
errorobject or nullError details ({message, type}) when failed, null otherwise
trigger_contextobjectTrigger source: {"type": "manual"}, {"type": "schedule"}, or {"type": "retry"}
session_idstringAssociated Session ID (present once session is created)
completed_atstringCompletion timestamp (ISO 8601, present when terminal)
duration_msintegerRun duration in milliseconds (present when completed)
cas_run_extrasobjectCAS-specific metadata: attempt, turn_id, started_at
triggered_atstringTrigger timestamp (ISO 8601)
created_atstringRecord creation time (ISO 8601)

​
Errors

HTTPTypeTrigger
401authentication_errorPAT invalid or expired
404not_found_errorDeployment does not exist
409conflict_errorDeployment is archived or not in active status
See Errors for the full error envelope.

Get a deployment run

Inspect the status and session ID of a single run.

List deployment runs

View the run history of this deployment.

List all runs

Query run history across all deployments.

Get a deployment

Inspect deployment configuration and next scheduled time.