.yaml not added to group URL
05:39 05 Mar 2026

When I change the property springdoc.swagger-ui.url to contain the .yaml extension, for example /v3/api-docs.yaml, I expect the URLs of the defined groups to include it as well. For example, with the following properties:

springdoc.group-configs[1].group=customer
springdoc.group-configs[1].display-name=Customers
springdoc.group-configs[1].paths-to-match=${app.public}

After opening Swagger UI, I expect a request to be made to fetch http://localhost:8083/v3/api-docs.yaml/customer. However, the request is made to http://localhost:8083/v3/api-docs/customer which results in an Unable to render this definition error. When I manually access http://localhost:8083/v3/api-docs.yaml/customer, the API file is downloaded.

Why is the .yaml extension not added even thought it is included in the property? Is this the intended behavior? If so, how can it be included?

java swagger openapi springdoc springdoc-openapi-ui