v51

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

dags

Enqueue a DAG-run from DAG

Creates a DAG-run from the DAG definition and adds it to the queue for execution

post/dags/{fileName}/enqueue

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 queued dag-run

profilestring

Runtime profile override. Empty string means no profile.

queuestring

Override the DAG-level queue definition

singletonboolean

If true, prevent enqueuing if DAG is already running or queued (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"
}