diff --git a/docs.json b/docs.json
index 7e738d5e6..21ad30272 100644
--- a/docs.json
+++ b/docs.json
@@ -1,553 +1 @@
-{
- "$schema": "https://mintlify.com/docs.json",
- "theme": "maple",
- "name": "Mintlify",
- "colors": {
- "primary": "#0D9373",
- "light": "#55D799",
- "dark": "#0D9373"
- },
- "favicon": "/favicon.ico",
- "icons": {
- "library": "lucide"
- },
- "navigation": {
- "tabs": [
- {
- "tab": "Documentation",
- "groups": [
- {
- "group": "Getting started",
- "pages": [
- "index",
- "quickstart",
- "installation",
- {
- "group": "Web editor",
- "icon": "mouse-pointer-2",
- "pages": [
- "editor/getting-started",
- "editor/git-concepts",
- "editor/branches",
- "editor/content-management",
- "editor/publishing",
- "editor/keyboard-shortcuts",
- "editor/troubleshooting"
- ]
- }
- ]
- },
- {
- "group": "Core configuration",
- "pages": [
- "settings",
- "pages",
- "navigation",
- "themes",
- "settings/custom-domain"
- ]
- },
- {
- "group": "AI optimization",
- "pages": [
- "guides/assistant",
- "ai/llmstxt",
- "ai/contextual-menu",
- "ai/model-context-protocol",
- "ai/markdown-export",
- "guides/geo",
- "guides/claude-code",
- "guides/cursor",
- "guides/windsurf"
- ]
- },
- {
- "group": "Components",
- "pages": [
- "text",
- "image-embeds",
- "list-table",
- "code",
- "reusable-snippets",
- "components/accordions",
- "components/callouts",
- "components/cards",
- "components/columns",
- "components/code-groups",
- "components/examples",
- "components/expandables",
- "components/fields",
- "components/frames",
- "components/icons",
- "components/mermaid-diagrams",
- "components/panel",
- "components/steps",
- "components/tabs",
- "components/tooltips",
- "components/update",
- "components/banner"
- ]
- },
- {
- "group": "API pages",
- "pages": [
- "api-playground/overview",
- "api-playground/openapi-setup",
- "api-playground/migrating-from-mdx",
- {
- "group": "Customization",
- "icon": "wrench",
- "pages": [
- "api-playground/customization/complex-data-types",
- "api-playground/customization/adding-sdk-examples",
- "api-playground/customization/managing-page-visibility",
- "api-playground/customization/multiple-responses"
- ]
- },
- {
- "group": "AsyncAPI",
- "icon": "webhook",
- "pages": [
- "api-playground/asyncapi/setup",
- "api-playground/asyncapi/playground"
- ]
- },
- {
- "group": "MDX",
- "icon": "markdown",
- "pages": [
- "api-playground/mdx/configuration",
- "api-playground/mdx/authentication"
- ]
- },
- "api-playground/troubleshooting"
- ]
- },
- {
- "group": "Authentication and personalization",
- "pages": [
- "authentication-personalization/authentication-setup",
- "authentication-personalization/personalization-setup"
- ]
- },
- {
- "group": "Guides",
- "pages": [
- "guides/migration",
- {
- "group": "Analytics dashboard",
- "icon": "chart-line",
- "pages": [
- "analytics/overview",
- "analytics/feedback",
- "analytics/search",
- "analytics/improving-docs"
- ]
- },
- "react-components",
- "settings/custom-scripts",
- "settings/seo",
- "guides/changelogs",
- "guides/hidden-pages",
- "settings/broken-links",
- "settings/custom-404-page",
- "guides/monorepo",
- {
- "group": "Custom subdirectory",
- "icon": "folder",
- "pages": [
- "advanced/subpath/cloudflare",
- "advanced/subpath/route53-cloudfront",
- "advanced/subpath/vercel",
- "guides/csp-configuration"
- ]
- },
- {
- "group": "Dashboard access",
- "icon": "gauge",
- "pages": [
- "advanced/dashboard/sso",
- "advanced/dashboard/permissions",
- "advanced/dashboard/roles"
- ]
- },
- "guides/deployments",
- "contact-support"
- ]
- },
- {
- "group": "Integrations",
- "pages": [
- {
- "group": "Analytics",
- "icon": "chart-no-axes-combined",
- "pages": [
- "integrations/analytics/overview",
- "integrations/analytics/amplitude",
- "integrations/analytics/clearbit",
- "integrations/analytics/fathom",
- "integrations/analytics/google-analytics",
- "integrations/analytics/google-tag-manager",
- "integrations/analytics/heap",
- "integrations/analytics/hightouch",
- "integrations/analytics/hotjar",
- "integrations/analytics/koala",
- "integrations/analytics/logrocket",
- "integrations/analytics/mixpanel",
- "integrations/analytics/pirsch",
- "integrations/analytics/plausible",
- "integrations/analytics/posthog",
- "integrations/analytics/segment"
- ]
- },
- {
- "group": "SDKs",
- "icon": "folder-code",
- "pages": [
- "integrations/sdks/speakeasy",
- "integrations/sdks/stainless"
- ]
- },
- {
- "group": "Support",
- "icon": "messages-square",
- "pages": [
- "integrations/support/overview",
- "integrations/support/intercom",
- "integrations/support/front"
- ]
- },
- {
- "group": "Privacy",
- "icon": "folder-lock",
- "pages": [
- "integrations/privacy/overview",
- "integrations/privacy/osano"
- ]
- }
- ]
- },
- {
- "group": "Version control and CI/CD",
- "pages": [
- "settings/github",
- "settings/gitlab",
- "settings/ci",
- "settings/preview-deployments"
- ]
- }
- ]
- },
- {
- "tab": "API Reference",
- "groups": [
- {
- "group": "API Reference",
- "pages": [
- "api-reference/introduction"
- ]
- },
- {
- "group": "Admin",
- "pages": [
- "api-reference/update/trigger",
- "api-reference/update/status"
- ]
- },
- {
- "group": "Assistant",
- "pages": [
- "api-reference/assistant/create-assistant-message",
- "api-reference/assistant/search"
- ]
- }
- ]
- },
- {
- "tab": "Changelog",
- "groups": [
- {
- "group": "Changelog",
- "pages": [
- "changelog"
- ]
- }
- ]
- }
- ]
- },
- "logo": {
- "light": "/logo/light.svg",
- "dark": "/logo/dark.svg",
- "href": "https://mintlify.com/docs"
- },
- "api": {
- "mdx": {
- "auth": {
- "method": "bearer"
- }
- }
- },
- "navbar": {
- "primary": {
- "type": "button",
- "label": "Get started",
- "href": "https://mintlify.com/start"
- }
- },
- "footer": {
- "socials": {
- "x": "https://x.com/mintlify",
- "linkedin": "https://www.linkedin.com/company/mintlify",
- "github": "https://github.com/mintlify"
- },
- "links": [
- {
- "header": "Explore",
- "items": [
- {
- "label": "Startups",
- "href": "https://www.mintlify.com/startups"
- },
- {
- "label": "Enterprise",
- "href": "https://www.mintlify.com/enterprise"
- },
- {
- "label": "Switch",
- "href": "https://www.mintlify.com/switch"
- }
- ]
- },
- {
- "header": "Resources",
- "items": [
- {
- "label": "Customers",
- "href": "https://mintlify.com/customers"
- },
- {
- "label": "Blog",
- "href": "https://mintlify.com/blog"
- },
- {
- "label": "Pricing",
- "href": "https://www.mintlify.com/pricing"
- },
- {
- "label": "Guides",
- "href": "https://www.mintlify.com/guides"
- },
- {
- "label": "Feature Requests",
- "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
- }
- ]
- },
- {
- "header": "Company",
- "items": [
- {
- "label": "Careers",
- "href": "https://mintlify.com/careers"
- },
- {
- "label": "Wall of Love",
- "href": "https://www.mintlify.com/wall-of-love"
- }
- ]
- },
- {
- "header": "Legal",
- "items": [
- {
- "label": "Privacy Policy",
- "href": "https://mintlify.com/legal/privacy"
- },
- {
- "label": "Terms of Service",
- "href": "https://mintlify.com/legal/terms"
- },
- {
- "label": "Security",
- "href": "https://security.mintlify.com/?_gl=1*ascm4x*_gcl_au*NTU1ODkzNjQ0LjE3NTQ5Mjg4NzIuMTgzMDQ5NTExMS4xNzU3NTQwMDk1LjE3NTc1NDAwOTQ."
- }
- ]
- }
- ]
- },
- "thumbnails": {
- "background": "/images/thumbnail/background.svg"
- },
- "contextual": {
- "options": [
- "copy",
- "chatgpt",
- "claude",
- "cursor",
- "vscode"
- ]
- },
- "redirects": [
- {
- "source": "/content/components/accordions",
- "destination": "/components/accordions"
- },
- {
- "source": "/content/components/callouts",
- "destination": "/components/callouts"
- },
- {
- "source": "/content/components/cards",
- "destination": "/components/cards"
- },
- {
- "source": "/content/components/card-groups",
- "destination": "/components/columns"
- },
- {
- "source": "/content/components/code-groups",
- "destination": "/components/code-groups"
- },
- {
- "source": "/content/components/examples",
- "destination": "/components/examples"
- },
- {
- "source": "/content/components/expandables",
- "destination": "/components/expandables"
- },
- {
- "source": "/content/components/fields",
- "destination": "/components/fields"
- },
- {
- "source": "/content/components/frames",
- "destination": "/components/frames"
- },
- {
- "source": "/content/components/icons",
- "destination": "/components/icons"
- },
- {
- "source": "/content/components/mermaid-diagrams",
- "destination": "/components/mermaid-diagrams"
- },
- {
- "source": "/content/components/steps",
- "destination": "/components/steps"
- },
- {
- "source": "/content/components/tabs",
- "destination": "/components/tabs"
- },
- {
- "source": "/content/components/tooltips",
- "destination": "/components/tooltips"
- },
- {
- "source": "/content/components/update",
- "destination": "/components/update"
- },
- {
- "source": "/api-playground/openapi/advanced-features",
- "destination": "/api-playground/customization"
- },
- {
- "source": "/api-playground/openapi/setup",
- "destination": "/api-playground/openapi-setup"
- },
- {
- "source": "/api-playground/openapi/writing-openapi",
- "destination": "/api-playground/openapi-setup"
- },
- {
- "source": "settings/authentication-personalization/authentication-vs-personalization",
- "destination": "authentication-personalization/overview"
- },
- {
- "source": "settings/authentication-personalization/authentication-setup/choosing-a-handshake",
- "destination": "authentication-personalization/overview"
- },
- {
- "source": "settings/authentication-personalization/personalization-setup/choosing-a-handshake",
- "destination": "authentication-personalization/overview"
- },
- {
- "source": "settings/authentication-personalization/authentication",
- "destination": "authentication-personalization/authentication-setup"
- },
- {
- "source": "settings/authentication-personalization/personalization",
- "destination": "authentication-personalization/personalization-setup"
- },
- {
- "source": "settings/authentication-personalization/partial-authentication",
- "destination": "authentication-personalization/authentication-setup"
- },
- {
- "source": "settings/authentication-personalization/sending-data",
- "destination": "authentication-personalization/personalization-setup"
- },
- {
- "source": "authentication-personalization/partial-authentication-setup",
- "destination": "authentication-personalization/authentication-setup"
- },
- {
- "source": "authentication-personalization/sending-data",
- "destination": "authentication-personalization/personalization-setup"
- },
- {
- "source": "settings/authentication-personalization/authentication-setup/jwt",
- "destination": "authentication-personalization/authentication-setup"
- },
- {
- "source": "settings/authentication-personalization/authentication-setup/oauth",
- "destination": "authentication-personalization/authentication-setup"
- },
- {
- "source": "settings/authentication-personalization/authentication-setup/mintlify",
- "destination": "authentication-personalization/authentication-setup"
- },
- {
- "source": "settings/authentication-personalization/authentication-setup/password",
- "destination": "authentication-personalization/authentication-setup"
- },
- {
- "source": "settings/authentication-personalization/personalization-setup/jwt",
- "destination": "authentication-personalization/personalization-setup"
- },
- {
- "source": "settings/authentication-personalization/personalization-setup/oauth",
- "destination": "authentication-personalization/personalization-setup"
- },
- {
- "source": "settings/authentication-personalization/personalization-setup/shared-session",
- "destination": "authentication-personalization/personalization-setup"
- },
- {
- "source": "ai-ingestion",
- "destination": "ai/llmstxt"
- },
- {
- "source": "api-reference/chat/*",
- "destination": "api-reference/assistant/*"
- },
- {
- "source": "editor",
- "destination": "editor/getting-started"
- },
- {
- "source": "guides/analytics",
- "destination": "analytics/overview"
- }
- ],
- "integrations": {
- "ga4": {
- "measurementId": "G-RCYWHL7EQ7"
- },
- "koala": {
- "publicApiKey": "pk_76a6caa274e800f3ceff0b2bc6b9b9d82ab8"
- }
- }
-}
\ No newline at end of file
+{\n \"$schema\": \"https://mintlify.com/docs.json\",\n \"theme\": \"maple\",\n \"name\": \"Mintlify\",\n \"colors\": {\n \"primary\": \"#0D9373\",\n \"light\": \"#55D799\",\n \"dark\": \"#0D9373\"\n },\n \"favicon\": \"/favicon.ico\",\n \"icons\": {\n \"library\": \"lucide\"\n },\n \"navigation\": {\n \"tabs\": [\n {\n \"tab\": \"Documentation\",\n \"groups\": [\n {\n \"group\": \"Getting started\",\n \"pages\": [\n \"index\",\n \"quickstart\",\n \"installation\",\n {\n \"group\": \"Web editor\",\n \"icon\": \"mouse-pointer-2\",\n \"pages\": [\n \"editor/getting-started\",\n \"editor/git-concepts\",\n \"editor/branches\",\n \"editor/content-management\",\n \"editor/publishing\",\n \"editor/keyboard-shortcuts\",\n \"editor/troubleshooting\"\n ]\n }\n ]\n },\n {\n \"group\": \"Core configuration\",\n \"pages\": [\n \"settings\",\n \"pages\",\n \"navigation\",\n \"themes\",\n \"settings/custom-domain\"\n ]\n },\n {\n \"group\": \"AI optimization\",\n \"pages\": [\n \"guides/assistant\",\n \"ai/llmstxt\",\n \"ai/contextual-menu\",\n \"ai/model-context-protocol\",\n \"ai/markdown-export\",\n \"guides/geo\",\n \"guides/claude-code\",\n \"guides/cursor\",\n \"guides/windsurf\"\n ]\n },\n {\n \"group\": \"Components\",\n \"pages\": [\n \"text\",\n \"image-embeds\",\n \"list-table\",\n \"code\",\n \"reusable-snippets\",\n \"components/accordions\",\n \"components/callouts\",\n \"components/cards\",\n \"components/columns\",\n \"components/code-groups\",\n \"components/examples\",\n \"components/expandables\",\n \"components/fields\",\n \"components/frames\",\n \"components/icons\",\n \"components/mermaid-diagrams\",\n \"components/panel\",\n \"components/steps\",\n \"components/tabs\",\n \"components/tooltips\",\n \"components/update\",\n \"components/banner\"\n ]\n },\n {\n \"group\": \"API pages\",\n \"pages\": [\n \"api-playground/overview\",\n \"api-playground/openapi-setup\",\n \"api-playground/migrating-from-mdx\",\n {\n \"group\": \"Customization\",\n \"icon\": \"wrench\",\n \"pages\": [\n \"api-playground/customization/complex-data-types\",\n \"api-playground/customization/adding-sdk-examples\",\n \"api-playground/customization/managing-page-visibility\",\n \"api-playground/customization/multiple-responses\"\n ]\n },\n {\n \"group\": \"AsyncAPI\",\n \"icon\": \"webhook\",\n \"pages\": [\n \"api-playground/asyncapi/setup\",\n \"api-playground/asyncapi/playground\"\n ]\n },\n {\n \"group\": \"MDX\",\n \"icon\": \"markdown\",\n \"pages\": [\n \"api-playground/mdx/configuration\",\n \"api-playground/mdx/authentication\"\n ]\n },\n \"api-playground/troubleshooting\"\n ]\n },\n {\n \"group\": \"Authentication and personalization\",\n \"pages\": [\n \"authentication-personalization/authentication-setup\",\n \"authentication-personalization/personalization-setup\"\n ]\n },\n {\n \"group\": \"Guides\",\n \"pages\": [\n \"guides/migration\",\n {\n \"group\": \"Analytics dashboard\",\n \"icon\": \"chart-line\",\n \"pages\": [\n \"analytics/overview\",\n \"analytics/feedback\",\n \"analytics/search\",\n \"analytics/improving-docs\"\n ]\n },\n \"react-components\",\n \"settings/custom-scripts\",\n \"settings/seo\",\n \"guides/changelogs\",\n \"guides/hidden-pages\",\n \"settings/broken-links\",\n \"settings/custom-404-page\",\n \"guides/monorepo\",\n {\n \"group\": \"Custom subdirectory\",\n \"icon\": \"folder\",\n \"pages\": [\n \"advanced/subpath/cloudflare\",\n \"advanced/subpath/route53-cloudfront\",\n \"advanced/subpath/vercel\",\n \"guides/csp-configuration\"\n ]\n },\n {\n \"group\": \"Dashboard access\",\n \"icon\": \"gauge\",\n \"pages\": [\n \"advanced/dashboard/sso\",\n \"advanced/dashboard/permissions\",\n \"advanced/dashboard/roles\"\n ]\n },\n \"guides/deployments\",\n \"contact-support\"\n ]\n },\n {\n \"group\": \"Integrations\",\n \"pages\": [\n {\n \"group\": \"Analytics\",\n \"icon\": \"chart-no-axes-combined\",\n \"pages\": [\n \"integrations/analytics/overview\",\n \"integrations/analytics/amplitude\",\n \"integrations/analytics/clearbit\",\n \"integrations/analytics/fathom\",\n \"integrations/analytics/google-analytics\",\n \"integrations/analytics/google-tag-manager\",\n \"integrations/analytics/heap\",\n \"integrations/analytics/hightouch\",\n \"integrations/analytics/hotjar\",\n \"integrations/analytics/koala\",\n \"integrations/analytics/logrocket\",\n \"integrations/analytics/mixpanel\",\n \"integrations/analytics/pirsch\",\n \"integrations/analytics/plausible\",\n \"integrations/analytics/posthog\",\n \"integrations/analytics/segment\"\n ]\n },\n {\n \"group\": \"SDKs\",\n \"icon\": \"folder-code\",\n \"pages\": [\n \"integrations/sdks/speakeasy\",\n \"integrations/sdks/stainless\"\n ]\n },\n {\n \"group\": \"Support\",\n \"icon\": \"messages-square\",\n \"pages\": [\n \"integrations/support/overview\",\n \"integrations/support/intercom\",\n \"integrations/support/front\",\n \"integrations/support/slack\"\n ]\n },\n {\n \"group\": \"Privacy\",\n \"icon\": \"folder-lock\",\n \"pages\": [\n \"integrations/privacy/overview\",\n \"integrations/privacy/osano\"\n ]\n }\n ]\n },\n {\n \"group\": \"Version control and CI/CD\",\n \"pages\": [\n \"settings/github\",\n \"settings/gitlab\",\n \"settings/ci\",\n \"settings/preview-deployments\"\n ]\n }\n ]\n },\n {\n \"tab\": \"API Reference\",\n \"groups\": [\n {\n \"group\": \"API Reference\",\n \"pages\": [\n \"api-reference/introduction\"\n ]\n },\n {\n \"group\": \"Admin\",\n \"pages\": [\n \"api-reference/update/trigger\",\n \"api-reference/update/status\"\n ]\n },\n {\n \"group\": \"Assistant\",\n \"pages\": [\n \"api-reference/assistant/create-assistant-message\",\n \"api-reference/assistant/search\"\n ]\n }\n ]\n },\n {\n \"tab\": \"Changelog\",\n \"groups\": [\n {\n \"group\": \"Changelog\",\n \"pages\": [\n \"changelog\"\n ]\n }\n ]\n }\n ]\n },\n \"logo\": {\n \"light\": \"/logo/light.svg\",\n \"dark\": \"/logo/dark.svg\",\n \"href\": \"https://mintlify.com/docs\"\n },\n \"api\": {\n \"mdx\": {\n \"auth\": {\n \"method\": \"bearer\"\n }\n }\n },\n \"navbar\": {\n \"primary\": {\n \"type\": \"button\",\n \"label\": \"Get started\",\n \"href\": \"https://mintlify.com/start\"\n }\n },\n \"footer\": {\n \"socials\": {\n \"x\": \"https://x.com/mintlify\",\n \"linkedin\": \"https://www.linkedin.com/company/mintlify\",\n \"github\": \"https://github.com/mintlify\"\n },\n \"links\": [\n {\n \"header\": \"Explore\",\n \"items\": [\n {\n \"label\": \"Startups\",\n \"href\": \"https://www.mintlify.com/startups\"\n },\n {\n \"label\": \"Enterprise\",\n \"href\": \"https://www.mintlify.com/enterprise\"\n },\n {\n \"label\": \"Switch\",\n \"href\": \"https://www.mintlify.com/switch\"\n }\n ]\n },\n {\n \"header\": \"Resources\",\n \"items\": [\n {\n \"label\": \"Customers\",\n \"href\": \"https://mintlify.com/customers\"\n },\n {\n \"label\": \"Blog\",\n \"href\": \"https://mintlify.com/blog\"\n },\n {\n \"label\": \"Pricing\",\n \"href\": \"https://www.mintlify.com/pricing\"\n },\n {\n \"label\": \"Guides\",\n \"href\": \"https://www.mintlify.com/guides\"\n },\n {\n \"label\": \"Feature Requests\",\n \"href\": \"https://github.com/orgs/mintlify/discussions/categories/feature-requests\"\n }\n ]\n },\n {\n \"header\": \"Company\",\n \"items\": [\n {\n \"label\": \"Careers\",\n \"href\": \"https://mintlify.com/careers\"\n },\n {\n \"label\": \"Wall of Love\",\n \"href\": \"https://www.mintlify.com/wall-of-love\"\n }\n ]\n },\n {\n \"header\": \"Legal\",\n \"items\": [\n {\n \"label\": \"Privacy Policy\",\n \"href\": \"https://mintlify.com/legal/privacy\"\n },\n {\n \"label\": \"Terms of Service\",\n \"href\": \"https://mintlify.com/legal/terms\"\n },\n {\n \"label\": \"Security\",\n \"href\": \"https://security.mintlify.com/?_gl=1*ascm4x*_gcl_au*NTU1ODkzNjQ0LjE3NTQ5Mjg4NzIuMTgzMDQ5NTExMS4xNzU3NTQwMDk1LjE3NTc1NDAwOTQ.\"\n }\n ]\n }\n ]\n },\n \"thumbnails\": {\n \"background\": \"/images/thumbnail/background.svg\"\n },\n \"contextual\": {\n \"options\": [\n \"copy\",\n \"chatgpt\",\n \"claude\",\n \"cursor\",\n \"vscode\"\n ]\n },\n \"redirects\": [\n {\n \"source\": \"/content/components/accordions\",\n \"destination\": \"/components/accordions\"\n },\n {\n \"source\": \"/content/components/callouts\",\n \"destination\": \"/components/callouts\"\n },\n {\n \"source\": \"/content/components/cards\",\n \"destination\": \"/components/cards\"\n },\n {\n \"source\": \"/content/components/card-groups\",\n \"destination\": \"/components/columns\"\n },\n {\n \"source\": \"/content/components/code-groups\",\n \"destination\": \"/components/code-groups\"\n },\n {\n \"source\": \"/content/components/examples\",\n \"destination\": \"/components/examples\"\n },\n {\n \"source\": \"/content/components/expandables\",\n \"destination\": \"/components/expandables\"\n },\n {\n \"source\": \"/content/components/fields\",\n \"destination\": \"/components/fields\"\n },\n {\n \"source\": \"/content/components/frames\",\n \"destination\": \"/components/frames\"\n },\n {\n \"source\": \"/content/components/icons\",\n \"destination\": \"/components/icons\"\n },\n {\n \"source\": \"/content/components/mermaid-diagrams\",\n \"destination\": \"/components/mermaid-diagrams\"\n },\n {\n \"source\": \"/content/components/steps\",\n \"destination\": \"/components/steps\"\n },\n {\n \"source\": \"/content/components/tabs\",\n \"destination\": \"/components/tabs\"\n },\n {\n \"source\": \"/content/components/tooltips\",\n \"destination\": \"/components/tooltips\"\n },\n {\n \"source\": \"/content/components/update\",\n \"destination\": \"/components/update\"\n },\n {\n \"source\": \"/api-playground/openapi/advanced-features\",\n \"destination\": \"/api-playground/customization\"\n },\n {\n \"source\": \"/api-playground/openapi/setup\",\n \"destination\": \"/api-playground/openapi-setup\"\n },\n {\n \"source\": \"/api-playground/openapi/writing-openapi\",\n \"destination\": \"/api-playground/openapi-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/authentication-vs-personalization\",\n \"destination\": \"authentication-personalization/overview\"\n },\n {\n \"source\": \"settings/authentication-personalization/authentication-setup/choosing-a-handshake\",\n \"destination\": \"authentication-personalization/overview\"\n },\n {\n \"source\": \"settings/authentication-personalization/personalization-setup/choosing-a-handshake\",\n \"destination\": \"authentication-personalization/overview\"\n },\n {\n \"source\": \"settings/authentication-personalization/authentication\",\n \"destination\": \"authentication-personalization/authentication-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/personalization\",\n \"destination\": \"authentication-personalization/personalization-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/partial-authentication\",\n \"destination\": \"authentication-personalization/authentication-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/sending-data\",\n \"destination\": \"authentication-personalization/personalization-setup\"\n },\n {\n \"source\": \"authentication-personalization/partial-authentication-setup\",\n \"destination\": \"authentication-personalization/authentication-setup\"\n },\n {\n \"source\": \"authentication-personalization/sending-data\",\n \"destination\": \"authentication-personalization/personalization-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/authentication-setup/jwt\",\n \"destination\": \"authentication-personalization/authentication-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/authentication-setup/oauth\",\n \"destination\": \"authentication-personalization/authentication-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/authentication-setup/mintlify\",\n \"destination\": \"authentication-personalization/authentication-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/authentication-setup/password\",\n \"destination\": \"authentication-personalization/authentication-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/personalization-setup/jwt\",\n \"destination\": \"authentication-personalization/personalization-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/personalization-setup/oauth\",\n \"destination\": \"authentication-personalization/personalization-setup\"\n },\n {\n \"source\": \"settings/authentication-personalization/personalization-setup/shared-session\",\n \"destination\": \"authentication-personalization/personalization-setup\"\n },\n {\n \"source\": \"ai-ingestion\",\n \"destination\": \"ai/llmstxt\"\n },\n {\n \"source\": \"api-reference/chat/*\",\n \"destination\": \"api-reference/assistant/*\"\n },\n {\n \"source\": \"editor\",\n \"destination\": \"editor/getting-started\"\n },\n {\n \"source\": \"guides/analytics\",\n \"destination\": \"analytics/overview\"\n }\n ],\n \"integrations\": {\n \"ga4\": {\n \"measurementId\": \"G-RCYWHL7EQ7\"\n },\n \"koala\": {\n \"publicApiKey\": \"pk_76a6caa274e800f3ceff0b2bc6b9b9d82ab8\"\n }\n }\n}
\ No newline at end of file
diff --git a/integrations/support/overview.mdx b/integrations/support/overview.mdx
index 21892b0c1..f156cc3e3 100644
--- a/integrations/support/overview.mdx
+++ b/integrations/support/overview.mdx
@@ -33,6 +33,13 @@ description: "Integrate with a support widget"
horizontal
>
+
+
## Enabling support integrations
diff --git a/integrations/support/slack.mdx b/integrations/support/slack.mdx
new file mode 100644
index 000000000..5c0066d1b
--- /dev/null
+++ b/integrations/support/slack.mdx
@@ -0,0 +1,115 @@
+---
+title: "Slack integration"
+description: "Get Writer Agent notifications and interact with your documentation through Slack"
+---
+
+The Slack integration enables your team to receive Writer Agent notifications and interact with your documentation directly through Slack. This integration provides real-time updates when documentation changes are completed and allows for seamless communication about documentation updates.
+
+## Features
+
+### Writer Agent notifications
+Receive automatic notifications in Slack when the Writer Agent completes documentation tasks, including:
+- Pull request completion updates
+- Documentation generation status
+- Error notifications and status updates
+
+### Direct message support
+The Slack bot can respond to direct messages from team members, enabling:
+- Quick documentation queries
+- Status updates on ongoing tasks
+- Interactive communication with the Writer Agent system
+
+### Message formatting
+The integration properly handles Slack-specific formatting:
+- **Bold text** using single asterisks
+- Links formatted as ``
+- User mentions as `<@USER_ID>`
+- Channel references as `<#CHANNEL_ID>`
+
+## Setup
+
+### Prerequisites
+- A Slack workspace with admin permissions
+- Writer Agent enabled on your Mintlify account
+- Access to create Slack apps in your workspace
+
+### Slack app configuration
+
+1. Create a new Slack app in your workspace
+2. Configure the following OAuth scopes for your bot:
+
+#### Required scopes
+- `im:read` - Read DM channel information
+- `im:write` - Send DM responses
+- `im:history` - **Critical:** Receive DM message events
+- `channels:history` - Receive channel message events
+- `groups:history` - Receive private channel events
+- `mpim:history` - Receive group DM events
+
+### Event subscriptions
+
+Configure these bot event subscriptions in your Slack app settings:
+
+- `message.im` - Direct message events
+- `message.channels` - Public channel messages
+- `message.groups` - Private channel messages
+- `message.mpim` - Group DM messages
+- `app_mention` - When the bot is mentioned
+
+### Integration setup
+
+1. Navigate to your [Mintlify dashboard](https://dashboard.mintlify.com)
+2. Go to **Integrations** → **Support**
+3. Select **Slack** from the available integrations
+4. Provide your Slack app credentials:
+ - Bot token
+ - Signing secret
+ - App ID
+
+## Usage
+
+### Receiving notifications
+
+Once configured, your team will automatically receive Slack notifications when:
+- Writer Agent completes documentation updates
+- Pull requests are processed
+- Documentation generation tasks finish
+- Errors occur during documentation processing
+
+### Direct messaging
+
+Team members can send direct messages to the bot for:
+- Checking the status of documentation tasks
+- Getting updates on specific pull requests
+- Receiving help with documentation-related queries
+
+### Channel integration
+
+The bot can be added to channels to:
+- Provide team-wide notifications
+- Respond to mentions and questions
+- Share documentation updates with relevant teams
+
+## Troubleshooting
+
+### Bot not responding to messages
+- Verify all required OAuth scopes are enabled
+- Check that event subscriptions are properly configured
+- Ensure the bot token has the necessary permissions
+
+### Missing notifications
+- Confirm the integration is enabled in your Mintlify dashboard
+- Verify the Slack app is installed in your workspace
+- Check that the bot has access to the relevant channels
+
+### Formatting issues
+- The bot automatically handles Slack formatting
+- Links and mentions are processed according to Slack's formatting standards
+- If formatting appears incorrect, verify your Slack app configuration
+
+## Support
+
+For additional help with the Slack integration:
+- Check your [Mintlify dashboard](https://dashboard.mintlify.com) for integration status
+- Review your Slack app configuration and permissions
+- Contact [Mintlify support](mailto:support@mintlify.com) for technical assistance
\ No newline at end of file