v51

latestOpenAPI 3.0.0GPL-3.0raw.githubusercontent.com2026-08-01199241439.9 KB

dag-runs

Manually update a step's execution status in a sub DAG-run

Changes the status of a specific step after the sub DAG-run and its embedded root run are no longer active

patch/dag-runs/{name}/{dagRunId}/sub-dag-runs/{subDAGRunId}/steps/{stepName}/status

Path parameters

namestring regex required

Name of the DAG

name of the DAG

dagRunIdstring required

Unique identifier for the DAG-run. The special value 'latest' can be used to reference the most recent DAG-run.

Example:latest

ID of the DAG-run or 'latest' to get the most recent DAG-run

subDAGRunIdstring required

ID of the sub DAG-run to update the step status for

stepNamestring required

name of the step

Query parameters

remoteNodestring

name of the remote node

Request body

status0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 required

Numeric status code indicating current node state: 0: "Not started" 1: "Running" 2: "Failed" 3: "Aborted" 4: "Success" 5: "Skipped" 6: "Partial Success" 7: "Waiting for manual action" 8: "Rejected" 9: "Retrying"

Response

A successful response