# Validating OpenAPI / Swagger on https://docs.discourse.org/openapi.json

**URL:** <https://meta.discourse.org/t/validating-openapi-swagger-on-https-docs-discourse-org-openapi-json/169612>\
**Category:** Bug\
**Tags:** rest-api\
**Created:** [November 9, 2020, 2:47pm UTC](https://meta.discourse.org/t/validating-openapi-swagger-on-https-docs-discourse-org-openapi-json/169612 "2020-11-09T14:47:44Z")\
**Posts on this page:** 1\
**Showing post:** 7

<div class="post-metadata">

**Author:** ![blake](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/blake/32/157322_2.png) [@blake](https://meta.discourse.org/u/blake)\
**Post date:** [January 4, 2021, 5:16pm UTC](https://meta.discourse.org/t/validating-openapi-swagger-on-https-docs-discourse-org-openapi-json/169612/7 "2021-01-04T17:16:56Z")

</div>

Just closing the loop on this topic. The submitted PR was closed after some discussion.

[https://github.com/discourse/discourse\_api\_docs/pull/25](https://github.com/discourse/discourse_api_docs/pull/25)

but I did follow it up with a commit that fixed the newline issues:

[https://github.com/discourse/discourse\_api\_docs/commit/c5f7b9e3c8b3791b4cdc1c0f16add98cfd9f9f37](https://github.com/discourse/discourse_api_docs/commit/c5f7b9e3c8b3791b4cdc1c0f16add98cfd9f9f37)

Also, just wanted to say that we are currently in the process of converting the api docs to be more [integrated with the discourse code base](https://github.com/discourse/discourse/tree/master/spec/requests/api) by using a tool called [rswag](https://github.com/rswag/rswag), that can auto generate the OpenAPI json spec file. I know there are some linting issues with the current docs, but I feel like our energy would be best spent investing in completing the transition to rswag which will help us address many of these issues.

---

_[View the full topic](https://meta.discourse.org/t/validating-openapi-swagger-on-https-docs-discourse-org-openapi-json/169612)._
