Sign in

v51

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

Create and execute a DAG-run from DAG

Creates a DAG-run from the DAG definition and starts its execution with optional parameters

post/dags/{fileName}/start

Path parameters

fileNamestring regex required

Name of the DAG file

the name of the DAG file

Query parameters

remoteNodestring

name of the remote node

Request body

paramsstring

Parameters to pass to the DAG-run in JSON format

dagRunIdstring

Optional ID for the DAG-run, if not provided a new one will be generated

dagNamestring

Optional DAG name override to use for the created dag-run

profilestring

Runtime profile override. Empty string means no profile.

singletonboolean

If true, prevent starting if DAG is already running (returns 409 conflict)

labelsstring[]

Additional labels to apply to the DAG-run (format: key=value or key-only). Merged with labels defined in the DAG spec. Mutually exclusive with deprecated tags; the server returns HTTP 400 if both are set.

tagsstring[]

Deprecated alias for Labels. Additional labels to apply to the DAG-run (format: key=value or key-only). Merged with labels defined in the DAG spec. Mutually exclusive with labels; the server returns HTTP 400 if both are set.

Example request

{
  "dagRunId": "latest"
}

Response

A successful response

dagRunIdstring required

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

Example response

{
  "dagRunId": "latest"
}