Repository navigation
Unique operationId in openapi #49607
Description
Apache Airflow version
3.0.0
If "Other Airflow 2 version" selected, which one?
No response
What happened?
When using the OpenAPI spec provided by Apache Airflow, tools that validate or consume the spec (such as openapi-core, openapi-spec-validator, and code generators) fail with a DuplicateOperationIDError. The error message states that the operationId 'get_task_instance_dependencies' is not unique, even though the routes for these operations are different.
This prevents automated tooling, client generation, and some integrations from working with the Airflow OpenAPI spec.
What you think should happen instead?
According to the OpenAPI specification, every operationId must be unique across the entire API, regardless of the route or HTTP method. The Airflow OpenAPI spec should ensure that all operationId values are unique.
How to reproduce
- Download the OpenAPI spec (openapi.json) from a running Airflow instance or from the Airflow source.(
http://localhost:8080/openapi.json) - Run any OpenAPI validator or code generator, such as:
from openapi_spec_validator import validate_spec
import json
with open("path/to/openapi.json") as f:
validate_spec(json.load(f))Operating System
ProductName: macOS ProductVersion: 15.4.1 BuildVersion: 24E263
Versions of Apache Airflow Providers
Not Applicable
Deployment
Virtualenv installation
Deployment details
No response
Anything else?
No response
Are you willing to submit PR?
- Yes I am willing to submit a PR!
Code of Conduct
- I agree to follow this project's Code of Conduct
Activity