Add option to specify the URL path for auto-generated API pages

[rhianvanesch-sc]

It's possible to auto-generate pages from an OpenAPI specification: https://www.mintlify.com/docs/api-playground/openapi-setup#auto-populate-api-pages, e.g. in docs.json:

{
  "group": "Pets",
  "openapi": "/path/to/openapi.yaml",
  "pages": ["POST /pets"]
},

For us, the generated page for POST /pets ends up with a URL path of /api-reference/${tags[0}/${summary}, where it seems to take the first entry in the tags field, and slugifies the summary field from the OpenAPI spec.

We would like more control over this generated URL, e.g. to change the prefix from /api-reference to something else, or add an additional prefix, e.g. /api-reference/v1 and /api-reference/v2.

The current workaround we have is to generate .mdx pages for every endpoint (docs) and place them into subfolders with the desired naming, but in some cases we would prefer to use the auto-generated pages.

[efe]

This is a great suggestion! There might be even additional field in x-mint as href too!

[rhianvanesch-sc]

Resolved: this can be done using the x-mint href field, as documented here: https://www.mintlify.com/docs/api-playground/openapi-setup#href