diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx index 37edd2e83..91cd2cce9 100644 --- a/api-playground/openapi-setup.mdx +++ b/api-playground/openapi-setup.mdx @@ -10,7 +10,7 @@ OpenAPI is a specification for describing APIs. Mintlify supports OpenAPI 3.0 an To document your endpoints with OpenAPI, you need one or more valid OpenAPI specifications in either JSON or YAML format that follow the [OpenAPI specification 3.0 or 3.1](https://swagger.io/specification/). -Add OpenAPI specifications to your documentation repository or host them online where you can access the specifications by URL. +Add OpenAPI specifications to your documentation repository or host them online where you can access the specifications by URL. Specifications stored in your repository are [served as downloadable files](/create/files) at their path on your docs domain. For example, `https://your-domain/docs/openapi.json`. Reference any number of OpenAPI specifications in the navigation element of your `docs.json` to create pages for your API endpoints. Each specification file generates its own set of endpoints.