Home
Apache Airflow
Airflow Clear Task Instances Body Structure
Airflow Clear Task Instances Body Structure
Request body for Clear Task Instances endpoint.
Type: object
Properties: 15
Workflow Orchestration Data Pipeline Open-Source Apache DAG Scheduling ETL Data Engineering
ClearTaskInstancesBody is a JSON Structure definition published by Apache Airflow, describing 15 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
Properties
dry_run
start_date
end_date
only_failed
only_running
reset_dag_runs
task_ids
dag_run_id
include_upstream
include_downstream
include_future
include_past
run_on_latest_version
prevent_running_task
note
Meta-schema: https://json-structure.org/meta/core/v0/#
JSON Structure
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/airflow/refs/heads/main/json-structure/airflow-clear-task-instances-body-structure.json",
"name": "ClearTaskInstancesBody",
"description": "Request body for Clear Task Instances endpoint.",
"type": "object",
"properties": {
"dry_run": {
"type": "boolean",
"title": "Dry Run",
"default": true
},
"start_date": {
"anyOf": [
{
"type": "datetime"
},
{
"type": "null"
}
],
"title": "Start Date"
},
"end_date": {
"anyOf": [
{
"type": "datetime"
},
{
"type": "null"
}
],
"title": "End Date"
},
"only_failed": {
"type": "boolean",
"title": "Only Failed",
"default": true
},
"only_running": {
"type": "boolean",
"title": "Only Running",
"default": false
},
"reset_dag_runs": {
"type": "boolean",
"title": "Reset Dag Runs",
"default": true
},
"task_ids": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"prefixItems": [
{
"type": "string"
},
{
"type": "int32"
}
],
"type": "array",
"maxItems": 2,
"minItems": 2
}
]
},
"type": "array"
},
{
"type": "null"
}
],
"title": "Task Ids",
"description": "A list of `task_id` or [`task_id`, `map_index`]. If only the `task_id` is provided for a mapped task, all of its map indices will be targeted."
},
"dag_run_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Dag Run Id"
},
"include_upstream": {
"type": "boolean",
"title": "Include Upstream",
"default": false
},
"include_downstream": {
"type": "boolean",
"title": "Include Downstream",
"default": false
},
"include_future": {
"type": "boolean",
"title": "Include Future",
"default": false
},
"include_past": {
"type": "boolean",
"title": "Include Past",
"default": false
},
"run_on_latest_version": {
"type": "boolean",
"title": "Run On Latest Version",
"description": "(Experimental) Run on the latest bundle version of the dag after clearing the task instances.",
"default": false
},
"prevent_running_task": {
"type": "boolean",
"title": "Prevent Running Task",
"default": false
},
"note": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"title": "Note"
}
},
"additionalProperties": false
}
Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/airflow-clear-task-instances-body-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms .
A second provider on the same verified email joins the account you already have.