Согласно спецификации OpenAPI (выделено мной):
Документ OpenAPI, соответствующий Спецификации OpenAPI, сам по себе является объектом JSON, который может быть представлен в формате JSON или YAML .
Swagger UI может обрабатывать определения JSON и YAML. Другие инструменты, связанные с OpenAPI, тоже должны - при условии, что они используют парсер YAML. Технически YAML - это расширенный набор JSON, поэтому инструменты, использующие анализаторы YAML (а не анализаторы JSON), могут анализировать как YAML, так и JSON.