Sign in
dag-runs

Retrieve detailed status of a DAG-run

Fetches detailed status information about a specific DAG-run. Use 'latest' as the dagRunId to retrieve the most recent DAG-run for the specified DAG name.

get/dag-runs/{name}/{dagRunId}

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

Query parameters

remoteNodestring

name of the remote node

Response

A successful response

Example response

{
  "dagRunDetails": {
    "dagRunId": "latest",
    "rootDAGRunId": "latest",
    "parentDAGRunId": "latest",
    "nodes": [
      {
        "subRuns": [
          {
            "dagRunId": "latest"
          }
        ],
        "subRunsRepeated": [
          {
            "dagRunId": "latest"
          }
        ]
      }
    ],
    "onExit": {
      "subRuns": [
        {
          "dagRunId": "latest"
        }
      ],
      "subRunsRepeated": [
        {
          "dagRunId": "latest"
        }
      ]
    },
    "onSuccess": {
      "subRuns": [
        {
          "dagRunId": "latest"
        }
      ],
      "subRunsRepeated": [
        {
          "dagRunId": "latest"
        }
      ]
    },
    "onFailure": {
      "subRuns": [
        {
          "dagRunId": "latest"
        }
      ],
      "subRunsRepeated": [
        {
          "dagRunId": "latest"
        }
      ]
    },
    "onAbort": {
      "subRuns": [
        {
          "dagRunId": "latest"
        }
      ],
      "subRunsRepeated": [
        {
          "dagRunId": "latest"
        }
      ]
    }
  }
}

Changes