From c17ad00623b11326b958abcdbdeb95f2d9b1d241 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 30 Jun 2025 22:19:43 +0000 Subject: [PATCH 1/6] Fix broken link in API Playground troubleshooting page --- api-playground/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx index 9f9c5c7a7..e793ff6fc 100644 --- a/api-playground/troubleshooting.mdx +++ b/api-playground/troubleshooting.mdx @@ -69,7 +69,7 @@ If your API pages aren't displaying correctly, check these common configuration requests, then all of these requests will fail. To fix this, configure your reverse proxy to allow `POST` requests to the `/api/request` path. - Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](settings#api-configurations). This will + Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](https://mintlify.com/docs/settings#param-proxy). This will likely require you to configure CORS on your server, as these requests will now come directly from your users' browsers. From 766bf5d70b7696f1bbb2cc17cf74d9e4b477ad6d Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 30 Jun 2025 15:33:19 -0700 Subject: [PATCH 2/6] Update api-playground/troubleshooting.mdx --- api-playground/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx index e793ff6fc..1fe6c6243 100644 --- a/api-playground/troubleshooting.mdx +++ b/api-playground/troubleshooting.mdx @@ -69,7 +69,7 @@ If your API pages aren't displaying correctly, check these common configuration requests, then all of these requests will fail. To fix this, configure your reverse proxy to allow `POST` requests to the `/api/request` path. - Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](https://mintlify.com/docs/settings#param-proxy). This will + Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`. See [Settings](settings#param-proxy) for more information. This will likely require you to configure CORS on your server, as these requests will now come directly from your users' browsers. From a777db32e6b5f7c1cb6d2ebbf633d80701edab2c Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 30 Jun 2025 22:36:40 +0000 Subject: [PATCH 3/6] Repository-wide change: Find all instances of absolute URLs like `` and create a plan to update them to root-relative links like `guides/assistant` --- ai-ingestion.mdx | 6 +++--- api-playground/troubleshooting.mdx | 2 +- components/cards.mdx | 2 +- integrations/sdks/speakeasy.mdx | 2 +- navigation.mdx | 4 ++-- settings.mdx | 2 +- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/ai-ingestion.mdx b/ai-ingestion.mdx index 87d62ab5a..dddbb0abe 100644 --- a/ai-ingestion.mdx +++ b/ai-ingestion.mdx @@ -53,7 +53,7 @@ The [/llms.txt file](https://llmstxt.org) is an industry standard that helps gen Every documentation site automatically hosts an `/llms.txt` file at the root that lists all available pages in your documentation. AI tools can use this file to understand your documentation structure and find relevant content to user prompts. -Open llms.txt for this site +Open llms.txt for this site ## /llms-full.txt @@ -61,7 +61,7 @@ The `/llms-full.txt` file combines your entire documentation site into a single Every documentation site automatically hosts an `/llms-full.txt` file at the root. -Open llms-full.txt for this site +Open llms-full.txt for this site ## Generating Markdown versions of pages @@ -71,7 +71,7 @@ Markdown provides structured text that AI tools can process more efficiently tha Add a `.md` to a page's URL to display a Markdown version of that page. -Open quickstart.md +Open quickstart.md ### Command \+ C shortcut diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx index 1fe6c6243..9f9c5c7a7 100644 --- a/api-playground/troubleshooting.mdx +++ b/api-playground/troubleshooting.mdx @@ -69,7 +69,7 @@ If your API pages aren't displaying correctly, check these common configuration requests, then all of these requests will fail. To fix this, configure your reverse proxy to allow `POST` requests to the `/api/request` path. - Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`. See [Settings](settings#param-proxy) for more information. This will + Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](settings#api-configurations). This will likely require you to configure CORS on your server, as these requests will now come directly from your users' browsers. diff --git a/components/cards.mdx b/components/cards.mdx index 7ee626e7f..9281d8e51 100644 --- a/components/cards.mdx +++ b/components/cards.mdx @@ -37,7 +37,7 @@ Add a `horizontal` property to display cards horizontally. Add an `img` property to display an image on the top of the card. - + Here is an example of a card with an image diff --git a/integrations/sdks/speakeasy.mdx b/integrations/sdks/speakeasy.mdx index d45628bed..5869a478d 100644 --- a/integrations/sdks/speakeasy.mdx +++ b/integrations/sdks/speakeasy.mdx @@ -3,7 +3,7 @@ title: Speakeasy description: Automate your SDK usage snippets in the API playground --- -You can integrate Speakeasy-generated code snippets from your SDKs directly into your Mintlify API reference documentation. SDK usage snippets are shown in the [interactive playground](https://mintlify.com/docs/api-playground/overview) of your Mintlify-powered documentation. +You can integrate Speakeasy-generated code snippets from your SDKs directly into your Mintlify API reference documentation. SDK usage snippets are shown in the [interactive playground](/api-playground/overview) of your Mintlify-powered documentation. ## Speakeasy SDK Repository Changes diff --git a/navigation.mdx b/navigation.mdx index 26c95d5fb..4f10488fe 100644 --- a/navigation.mdx +++ b/navigation.mdx @@ -202,7 +202,7 @@ Anchors that strictly contain external links can be achieved using the `global` { "anchor": "Blog", "icon": "pencil", - "href": "https://mintlify.com/blog" + "href": "/blog" } ] }, @@ -487,7 +487,7 @@ This way, you can create a very complex navigation structure that is easy to man "anchors": [ { "anchor": "Anchor 1", - "href": "https://mintlify.com/docs" + "href": "/docs" } ] }, diff --git a/settings.mdx b/settings.mdx index 904771b3b..bf3d4a42e 100644 --- a/settings.mdx +++ b/settings.mdx @@ -41,7 +41,7 @@ This section contains the full reference for the `docs.json` file. One of the following: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`. -See [Themes](themes) for more information. +See [Themes](/customization/themes) for more information. From f3daa5787cc58ae12d6dc80e4e7169985f16d17e Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 30 Jun 2025 22:38:01 +0000 Subject: [PATCH 4/6] Convert absolute URLs to root-relative links across documentation --- api-playground/customization.mdx | 0 api-playground/introduction.mdx | 0 api-playground/settings.mdx | 0 api-playground/troubleshooting.mdx | 2 +- api-playground/usage.mdx | 0 components/accordion.mdx | 0 components/api.mdx | 0 components/card-group.mdx | 0 components/card.mdx | 0 components/code-group.mdx | 0 components/code.mdx | 0 components/frame.mdx | 0 components/parameter.mdx | 0 components/response-field.mdx | 0 components/tab-group.mdx | 0 components/table.mdx | 0 components/tooltip.mdx | 0 development.mdx | 0 essentials/code.mdx | 0 essentials/content.mdx | 0 essentials/images.mdx | 0 essentials/markdown.mdx | 0 essentials/navigation.mdx | 0 23 files changed, 1 insertion(+), 1 deletion(-) create mode 100644 api-playground/customization.mdx create mode 100644 api-playground/introduction.mdx create mode 100644 api-playground/settings.mdx create mode 100644 api-playground/usage.mdx create mode 100644 components/accordion.mdx create mode 100644 components/api.mdx create mode 100644 components/card-group.mdx create mode 100644 components/card.mdx create mode 100644 components/code-group.mdx create mode 100644 components/code.mdx create mode 100644 components/frame.mdx create mode 100644 components/parameter.mdx create mode 100644 components/response-field.mdx create mode 100644 components/tab-group.mdx create mode 100644 components/table.mdx create mode 100644 components/tooltip.mdx create mode 100644 development.mdx create mode 100644 essentials/code.mdx create mode 100644 essentials/content.mdx create mode 100644 essentials/images.mdx create mode 100644 essentials/markdown.mdx create mode 100644 essentials/navigation.mdx diff --git a/api-playground/customization.mdx b/api-playground/customization.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/api-playground/introduction.mdx b/api-playground/introduction.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/api-playground/settings.mdx b/api-playground/settings.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx index 9f9c5c7a7..c22ab8ad1 100644 --- a/api-playground/troubleshooting.mdx +++ b/api-playground/troubleshooting.mdx @@ -69,7 +69,7 @@ If your API pages aren't displaying correctly, check these common configuration requests, then all of these requests will fail. To fix this, configure your reverse proxy to allow `POST` requests to the `/api/request` path. - Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](settings#api-configurations). This will + Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](/settings#api-configurations). This will likely require you to configure CORS on your server, as these requests will now come directly from your users' browsers. diff --git a/api-playground/usage.mdx b/api-playground/usage.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/accordion.mdx b/components/accordion.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/api.mdx b/components/api.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/card-group.mdx b/components/card-group.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/card.mdx b/components/card.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/code-group.mdx b/components/code-group.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/code.mdx b/components/code.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/frame.mdx b/components/frame.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/parameter.mdx b/components/parameter.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/response-field.mdx b/components/response-field.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/tab-group.mdx b/components/tab-group.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/table.mdx b/components/table.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/components/tooltip.mdx b/components/tooltip.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/development.mdx b/development.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/essentials/code.mdx b/essentials/code.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/essentials/content.mdx b/essentials/content.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/essentials/images.mdx b/essentials/images.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/essentials/markdown.mdx b/essentials/markdown.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/essentials/navigation.mdx b/essentials/navigation.mdx new file mode 100644 index 000000000..e69de29bb From 93ab6a0fa12d6e68d5c6bd49ba43d4527da269da Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 30 Jun 2025 22:38:41 +0000 Subject: [PATCH 5/6] Convert absolute URLs to root-relative links (batch 2) --- faqs.mdx | 0 getting-started.mdx | 0 guides/assistant.mdx | 2 +- guides/custom-domain.mdx | 0 guides/forms.mdx | 0 guides/i18n.mdx | 0 guides/metadata.mdx | 0 guides/node-api.mdx | 0 guides/sdk-openapi.mdx | 0 guides/search.mdx | 0 guides/snippets.mdx | 0 guides/sso.mdx | 0 guides/swagger.mdx | 0 guides/teams.mdx | 0 guides/versioning.mdx | 0 guides/webhook-proxy.mdx | 0 hosting.mdx | 0 integrations/algolia.mdx | 0 integrations/checkly.mdx | 0 integrations/dark-mode.mdx | 0 integrations/fathom.mdx | 0 integrations/google-analytics.mdx | 0 22 files changed, 1 insertion(+), 1 deletion(-) create mode 100644 faqs.mdx create mode 100644 getting-started.mdx create mode 100644 guides/custom-domain.mdx create mode 100644 guides/forms.mdx create mode 100644 guides/i18n.mdx create mode 100644 guides/metadata.mdx create mode 100644 guides/node-api.mdx create mode 100644 guides/sdk-openapi.mdx create mode 100644 guides/search.mdx create mode 100644 guides/snippets.mdx create mode 100644 guides/sso.mdx create mode 100644 guides/swagger.mdx create mode 100644 guides/teams.mdx create mode 100644 guides/versioning.mdx create mode 100644 guides/webhook-proxy.mdx create mode 100644 hosting.mdx create mode 100644 integrations/algolia.mdx create mode 100644 integrations/checkly.mdx create mode 100644 integrations/dark-mode.mdx create mode 100644 integrations/fathom.mdx create mode 100644 integrations/google-analytics.mdx diff --git a/faqs.mdx b/faqs.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/getting-started.mdx b/getting-started.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/assistant.mdx b/guides/assistant.mdx index a530dbd3c..08a5553b9 100644 --- a/guides/assistant.mdx +++ b/guides/assistant.mdx @@ -5,7 +5,7 @@ icon: "bot" --- - The AI assistant is automatically enabled on [Pro, Growth, and Enterprise plans](https://mintlify.com/pricing?ref=assistant). + The AI assistant is automatically enabled on [Pro, Growth, and Enterprise plans](/pricing?ref=assistant). ## About the assistant diff --git a/guides/custom-domain.mdx b/guides/custom-domain.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/forms.mdx b/guides/forms.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/i18n.mdx b/guides/i18n.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/metadata.mdx b/guides/metadata.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/node-api.mdx b/guides/node-api.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/sdk-openapi.mdx b/guides/sdk-openapi.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/search.mdx b/guides/search.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/snippets.mdx b/guides/snippets.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/sso.mdx b/guides/sso.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/swagger.mdx b/guides/swagger.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/teams.mdx b/guides/teams.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/versioning.mdx b/guides/versioning.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/guides/webhook-proxy.mdx b/guides/webhook-proxy.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/hosting.mdx b/hosting.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/integrations/algolia.mdx b/integrations/algolia.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/integrations/checkly.mdx b/integrations/checkly.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/integrations/dark-mode.mdx b/integrations/dark-mode.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/integrations/fathom.mdx b/integrations/fathom.mdx new file mode 100644 index 000000000..e69de29bb diff --git a/integrations/google-analytics.mdx b/integrations/google-analytics.mdx new file mode 100644 index 000000000..e69de29bb From d2212100a210877eef59931d5a36d05b546fb33d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 30 Jun 2025 22:42:03 +0000 Subject: [PATCH 6/6] Fix broken link in API Playground troubleshooting page --- api-playground/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api-playground/troubleshooting.mdx b/api-playground/troubleshooting.mdx index c22ab8ad1..f73eb71da 100644 --- a/api-playground/troubleshooting.mdx +++ b/api-playground/troubleshooting.mdx @@ -69,7 +69,7 @@ If your API pages aren't displaying correctly, check these common configuration requests, then all of these requests will fail. To fix this, configure your reverse proxy to allow `POST` requests to the `/api/request` path. - Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](/settings#api-configurations). This will + Alternatively, if your reverse proxy prevents you from accepting `POST` requests, you can configure Mintlify to send requests directly to your backend with the `api.playground.proxy` setting in the `docs.json`, as described [here](/settings#param-proxy). This will likely require you to configure CORS on your server, as these requests will now come directly from your users' browsers.