pause_dag
Pause a DAG to prevent new scheduled runs while allowing currently running tasks to complete. Use when you need to stop scheduled execution without terminating active tasks.
Instructions
Pause a DAG to prevent new scheduled runs from starting.
Use this tool when the user asks to:
"Pause DAG X" or "Stop DAG Y from running"
"Disable DAG Z" or "Prevent new runs of DAG X"
"Turn off DAG scheduling" or "Suspend DAG execution"
When a DAG is paused:
No new scheduled runs will be created
Currently running tasks will complete
Manual triggers are still possible
The DAG remains visible in the UI with a paused indicator
IMPORTANT: This is a write operation that modifies Airflow state. The DAG will remain paused until explicitly unpaused.
Args: dag_id: The ID of the DAG to pause (e.g., "example_dag")
Returns: JSON with updated DAG details showing is_paused=True
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dag_id": "<dag_id>"
},
"name": "pause_dag"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dag_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |