# Mintlify

> Mintlify is a platform for building and hosting documentation websites. It provides a set of tools and services for maintaining documentation and making it accessible to AI agents.

## Docs

- [Customize agent behavior](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/customize.md): Customize agent behavior with an `AGENTS.md` configuration file to control how the agent handles documentation tasks and follows your conventions.
- [Write effective prompts](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/effective-prompts.md): Write clear, specific prompts to get better results from the Mintlify agent, with examples of effective instructions and tips for common patterns.
- [What is the agent?](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/index.md): Automate documentation updates with the Mintlify agent. Trigger changes from Slack messages, pull requests, Linear issues, or API calls.
- [Add the agent to Linear](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/linear.md): Connect the Mintlify agent to Linear so it can read issues and comments, build context from project activity, and open documentation pull requests.
- [Connect Notion to the agent](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/notion.md): Connect Notion to the Mintlify agent so it can reference your workspace pages and databases as context when creating documentation updates.
- [Add the agent to Slack](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/slack.md): Add the Mintlify agent to Slack to ask questions about your docs, create documentation updates from conversations, and capture team knowledge.
- [Use cases](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/use-cases.md): Explore real-world examples of using the Mintlify agent to automate documentation updates, capture knowledge, and maintain accurate docs.
- [Workflows](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/agent/workflows.md): Set up automated documentation workflows with scheduled or event-triggered agent tasks, including cron schedules and webhook-based automation.
- [AI-native documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/ai-native.md): Discover how AI-native features enhance reading, writing, and discovering your documentation with the assistant, agent, and MCP server.
- [Contextual menu](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/ai/contextual-menu.md): Add a contextual menu to your docs with one-click AI integrations for ChatGPT, Claude, Perplexity, Google AI Studio, Devin, Windsurf, and MCP tools.
- [llms.txt](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/ai/llmstxt.md): Automatically generate llms.txt and llms-full.txt files so AI tools like ChatGPT and Claude can index and understand your documentation.
- [Markdown export](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/ai/markdown-export.md): Export clean Markdown versions of your documentation pages for AI tools, LLM integrations, and automated content processing workflows.
- [Model Context Protocol](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/ai/model-context-protocol.md): Connect your documentation and API endpoints to AI tools like Claude and Cursor with a hosted Model Context Protocol (MCP) server.
- [skill.md](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/ai/skillmd.md): Make your documentation agent-ready with automatically generated skill.md files that describe your product's capabilities for AI agents.
- [Add SDK examples](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/adding-sdk-examples.md): Add SDK code samples to your API documentation with autogenerated examples from Speakeasy and Stainless across multiple languages.
- [AsyncAPI setup](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/asyncapi-setup.md): Set up real-time WebSocket documentation using AsyncAPI specification files to generate interactive channel and message reference pages.
- [Complex data types](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/complex-data-types.md): Describe APIs with flexible schemas using oneOf, anyOf, and allOf keywords for optional properties, polymorphism, and multiple data formats.
- [Manage page visibility](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/managing-page-visibility.md): Control which API endpoints appear in your documentation navigation by hiding, filtering, or organizing autogenerated OpenAPI pages.
- [Create manual API pages](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/mdx-setup.md): Create API reference pages manually with MDX files when you need full control over layout for small APIs, prototypes, or custom docs.
- [Multiple responses](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/multiple-responses.md): Document multiple response variations for API endpoints, including success and error cases, with status codes and example payloads.
- [OpenAPI setup](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/openapi-setup.md): Generate interactive API documentation from OpenAPI specification files with automatic endpoint pages, request builders, and navigation.
- [Playground](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/overview.md): Let developers test API endpoints directly in your documentation with an interactive playground that sends real requests and shows responses.
- [Troubleshooting](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api-playground/troubleshooting.md): Troubleshoot common issues with API playground configuration, including OpenAPI validation errors, missing endpoints, and auth problems.
- [Create agent job](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/agent/v2/create-agent-job.md): Create an agent job that runs in the background and automatically creates a pull request with documentation changes.
- [Get agent job](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/agent/v2/get-agent-job.md): Retrieve the status and details of an agent job, including progress and pull request link.
- [Send follow-up message](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/agent/v2/send-message.md): Send a follow-up message to an existing agent job to provide additional instructions.
- [Get assistant caller stats](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/analytics/assistant-caller-stats.md): Retrieve a breakdown of assistant query counts by caller type for a given date range.
- [Get assistant conversations](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/analytics/assistant-conversations.md): Retrieve AI assistant conversation history including queries, responses, cited sources, and categories.
- [Get feedback](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/analytics/feedback.md): Retrieve user feedback from your documentation, including page ratings and code snippet feedback.
- [Get feedback by page](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/analytics/feedback-by-page.md): Retrieve user feedback counts aggregated by documentation page, including thumbs up/down ratings and code snippet feedback.
- [Get search queries](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/analytics/searches.md): Retrieve documentation search terms with hit counts, click-through rates, and top clicked pages.
- [Get page views](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/analytics/views.md): Retrieve per-page and site-wide content view counts, split by human and AI traffic.
- [Get unique visitors](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/analytics/visitors.md): Retrieve per-page and site-wide approximate unique visitor counts, split by human and AI traffic.
- [Create assistant message](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/assistant/create-assistant-message-v2.md): Send messages to the AI assistant and receive streaming responses using AI SDK v5 or later with the useChat hook.
- [Get page content](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/assistant/get-page-content.md): Retrieve the full text content of a documentation page by its path.
- [Search documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/assistant/search.md): Search your documentation programmatically and retrieve relevant pages matching the query.
- [Introduction](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/introduction.md): Use the Mintlify REST API to trigger deployments, embed an AI assistant, export analytics data, and manage documentation programmatically.
- [Trigger preview deployment](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/preview/trigger.md): Create or update a preview deployment for a specific branch to review documentation changes before merging to production.
- [Get deployment status](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/update/status.md): Check the status of a documentation deployment to monitor progress and completion.
- [Trigger deployment](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/api/update/trigger.md): Trigger a documentation deployment programmatically to publish updates outside of Git workflows.
- [Configure the assistant](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/assistant/configure.md): Configure the AI assistant in your Mintlify dashboard: toggle availability, customize responses, add starter questions, set bot protection, and manage billing.
- [Customize assistant behavior](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/assistant/customize.md): Customize the AI assistant by adding an Assistant.md file with system instructions that shape its tone, persona, focus areas, and response behavior.
- [Assistant](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/assistant/index.md): Add an AI-powered chat assistant to your documentation site that answers user questions, cites sources, and generates code examples on demand.
- [Use the assistant](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/assistant/use.md): Open the assistant with keyboard shortcuts, highlighted text, code blocks, file attachments, or URL parameters. Test assistant behavior in local preview.
- [Analyze your documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/cli/analytics.md): Use the mint analytics command to view traffic, search queries, user feedback, and AI assistant conversations directly from your terminal.
- [Commands](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/cli/commands.md): Complete reference for every Mintlify CLI command and flag, including mint dev, mint build, mint validate, mint analytics, and more.
- [Mintlify CLI](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/cli/index.md): Use the Mintlify CLI to preview docs locally, test changes in real time, analyze site performance, and run quality checks before deploying.
- [Install the CLI](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/cli/install.md): Install the Mintlify CLI to preview documentation locally, test changes in real time, and catch build errors before deploying to production.
- [Preview locally](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/cli/preview.md): Run a local preview of your Mintlify documentation site with live reload, full-text search, and AI assistant support using mint dev.
- [Accordions](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/accordions.md): Use the accordion component to show and hide content sections, organize related information, and enable progressive disclosure in your docs.
- [Badge](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/badge.md): Use the badge component to highlight status indicators, version labels, or metadata inline with customizable colors and hover tooltips.
- [Banner](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/banner.md): Add a dismissible banner at the top of your documentation site to display important announcements, release notes, or notifications.
- [Callouts](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/callouts.md): Add info, notes, tips, checks, warnings, danger, and custom callout components to highlight important information in your documentation.
- [Cards](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/cards.md): Use card components to display links, icons, images, and grouped content as visual containers that organize navigation.
- [Code groups](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/code-groups.md): Use the CodeGroup component to display multiple code examples in a tabbed interface and let readers compare implementations across languages.
- [Color](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/color.md): Display color swatches with hex values and click-to-copy capability using the color component for design system and branding documentation.
- [Columns](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/columns.md): Arrange cards and other components in a responsive multi-column grid layout with the columns component, including customizable column counts.
- [Examples](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/examples.md): Display code examples in the right sidebar panel on desktop devices to show request and response samples alongside API documentation.
- [Expandables](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/expandables.md): Use the expandable component to toggle nested object properties in API documentation, showing child fields for request and response objects.
- [Fields](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/fields.md): Use ParamField and ResponseField components to document API request and response parameters with types, defaults, and validation rules.
- [Frames](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/frames.md): Wrap images, videos, and other components with the frame component to add styled borders, captions, and visual emphasis to your content.
- [Icons](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/icons.md): Add icons from Font Awesome, Lucide, Tabler, or custom sources to your documentation pages using the icon component with size and color options.
- [Overview](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/index.md): Browse the full Mintlify component library for layout, emphasis, API documentation, and navigation elements available in your MDX pages.
- [Mermaid](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/mermaid-diagrams.md): Create flowcharts, sequence diagrams, and other visualizations in your documentation using Mermaid syntax with automatic rendering.
- [Panel](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/panel.md): Customize the right side panel content on documentation pages to display supplementary information, examples, or navigation elements.
- [Prompt](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/prompt.md): Display pre-built AI prompts with one-click copy and Cursor integration buttons so users can quickly use prompts in their AI tools.
- [Response fields](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/responses.md): Document API response fields using the ResponseField component with type annotations, descriptions, and required or optional indicators.
- [Steps](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/steps.md): Create numbered step-by-step procedures with the steps component to guide users through sequential tasks, tutorials, and setup workflows.
- [Tabs](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/tabs.md): Use the tab component to organize content into switchable panels for showing different options, platform versions, or language examples.
- [Tiles](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/tiles.md): Use the tiles component to display visual previews with image thumbnails, titles, and descriptions in a responsive grid layout for your docs.
- [Tooltips](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/tooltips.md): Add tooltips to display contextual definitions and explanations when users hover over terms, abbreviations, or technical concepts in your documentation.
- [Tree](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/tree.md): Use the tree component to display hierarchical file and folder structures with collapsible nodes and syntax highlighting for path names.
- [Update](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/update.md): Use the update component to display product updates, release notes, and changelog entries in a structured timeline format with dates.
- [View](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/view.md): Use the view component to create switchable content panels for different programming languages, frameworks, or configuration alternatives.
- [Visibility](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/components/visibility.md): Use the visibility component to show different content to humans on the web UI and to AI agents in Markdown output for conditional rendering.
- [Changelogs](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/changelogs.md): Create product changelogs with date-based entries, RSS feed support, and subscriber notifications to keep users informed about updates.
- [Format code](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/code.md): Format code in your documentation with syntax highlighting, line numbers, diffs, copy buttons, and interactive code group features in MDX.
- [Files](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/files.md): Serve static assets like images, videos, PDFs, and data files from your documentation repository with automatic optimization and CDN delivery.
- [Images and embeds](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/image-embeds.md): Add images, embed YouTube videos, and include iframes in your MDX pages to enhance documentation with visual and interactive media content.
- [Lists and tables](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/list-table.md): Format structured data in your documentation with Markdown tables, ordered and unordered lists, nested structures, and task list checkboxes.
- [Personalized content](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/personalization.md): Show personalized content based on user authentication data, group memberships, and custom variables to tailor documentation per audience.
- [Redirects](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/redirects.md): Configure URL redirects in docs.json for moved, renamed, or deleted documentation pages to preserve SEO rankings and prevent broken links.
- [Reusable snippets](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/reusable-snippets.md): Create reusable content snippets with variables to maintain consistency across documentation pages and reduce duplication in your MDX files.
- [Format text](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/create/text.md): Format text in your documentation with Markdown headings, bold, italic, links, blockquotes, and other inline styling options in MDX pages.
- [Custom 404 page](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/customize/custom-404-page.md): Customize the title, description, and appearance of your documentation site's 404 error page to match your brand and guide visitors.
- [Custom domain](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/customize/custom-domain.md): Host your documentation on a custom domain with DNS configuration, automatic TLS certificates, and subdomain or subpath routing options.
- [Custom scripts](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/customize/custom-scripts.md): Add custom JavaScript and CSS scripts to your documentation site for analytics, widgets, styling overrides, and third-party integrations.
- [Fonts](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/customize/fonts.md): Customize typography on your documentation site with Google Fonts or self-hosted font files for headings, body text, and code blocks.
- [React](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/customize/react-components.md): Build interactive and reusable elements with custom React components in your Mintlify documentation using JSX, state, and client-side logic.
- [Themes](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/customize/themes.md): Choose and configure a theme to customize your documentation site's colors, dark mode behavior, layout style, and overall visual appearance.
- [Audit logs](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/dashboard/audit-logs.md): Review audit logs to track actions performed by organization members, including deployments, configuration changes, and permission updates.
- [Deployment permissions](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/dashboard/permissions.md): Understand deployment permission levels for organization members versus external contributors, including branch protection and merge access.
- [Roles](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/dashboard/roles.md): Assign admin, editor, or viewer roles to team members to control access levels, editing permissions, and deployment capabilities in Mintlify.
- [Security contact](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/dashboard/security-contact.md): Configure a security contact email address for your organization to receive vulnerability reports, security alerts, and compliance updates.
- [Single sign-on (SSO)](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/dashboard/sso.md): Set up single sign-on with SAML or OIDC identity providers like Okta, Azure AD, and Google Workspace for secure team authentication.
- [Authentication setup](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/authentication-setup.md): Set up user authentication for your documentation site with OAuth, JWT, or shared links to control access to pages and API references.
- [CI checks](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/ci.md): Automate documentation quality checks in your CI/CD pipeline with broken link detection, linting, grammar validation, and build previews.
- [Cloudflare](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/cloudflare.md): Deploy your Mintlify documentation at a subpath on your domain using Cloudflare Workers with step-by-step setup and DNS configuration.
- [Content Security Policy (CSP) configuration](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/csp-configuration.md): Configure Content Security Policy headers to allow Mintlify resources while maintaining security for reverse proxies and strict network policies.
- [Deployments](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/deployments.md): Manage documentation deployments in the Mintlify dashboard, including viewing deployment history, monitoring build status, and troubleshooting.
- [Overview](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/docs-subpath.md): Host your Mintlify documentation at a /docs subpath on your main domain using Cloudflare Workers, Vercel rewrites, or an nginx reverse proxy.
- [Offline export](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/export.md): Export your documentation site as a self-contained zip archive for offline viewing, internal distribution, or air-gapped environment hosting.
- [GitHub Enterprise Server](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/ghes.md): Install and configure the Mintlify GitHub App on your GitHub Enterprise Server instance for automated documentation deployments and syncing.
- [GitHub](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/github.md): Connect your GitHub repository to Mintlify for automated deployments, pull request preview builds, and continuous documentation synchronization.
- [GitLab](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/gitlab.md): Connect your GitLab repository to Mintlify for automated documentation deployments, merge request previews, and continuous synchronization.
- [Monorepo setup](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/monorepo.md): Configure the documentation path and content directory in a monorepo project so Mintlify deploys only from your designated docs folder.
- [Preview deployments](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/preview-deployments.md): Get unique preview URLs for each pull request so reviewers can see documentation changes in a live environment before merging to production.
- [Reverse proxy](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/reverse-proxy.md): Configure a custom reverse proxy with Nginx, Apache, or Caddy to serve your Mintlify documentation at a subpath on your own domain.
- [AWS Route 53 and CloudFront](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/route53-cloudfront.md): Deploy your Mintlify documentation at a subpath on AWS using Route 53 for DNS routing and CloudFront as a CDN with Lambda@Edge functions.
- [Vercel](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/vercel.md): Configure Vercel rewrites to serve your Mintlify documentation at a subpath on your main domain with step-by-step vercel.json setup.
- [External proxies with Vercel](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/deploy/vercel-external-proxies.md): Configure external reverse proxies like Cloudflare or Nginx in front of your Vercel deployment to serve Mintlify docs at a custom subpath.
- [Collaborate in the web editor](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/collaborate.md): Collaborate on documentation in the web editor with branches, pull requests, preview deployments, shareable links, and real-time editing.
- [Configurations](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/configurations.md): Edit page metadata, navigation elements, and media settings using the visual configuration sheets in the Mintlify web editor sidebar.
- [Git essentials for the web editor](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/git-essentials.md): Understand the Git version control concepts behind the Mintlify web editor, including branches, commits, pull requests, and merge workflows.
- [Web editor overview](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/index.md): Create, edit, and publish documentation directly in your browser with visual editing, live preview, Git sync, and team collaboration tools.
- [Keyboard shortcuts](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/keyboard-shortcuts.md): View the complete list of keyboard shortcuts for the Mintlify web editor, including text formatting, navigation, and editing key commands.
- [Live preview](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/live-preview.md): Preview your documentation site in real time as you edit with the web editor's side-by-side live preview and responsive viewport options.
- [Add media](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/media.md): Upload, manage, and embed images and other media assets in your documentation pages using the Mintlify web editor's built-in file manager.
- [Organize navigation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/navigation.md): Organize your documentation site structure with the visual navigation editor to create groups, reorder pages, and manage the sidebar layout.
- [Create and edit pages](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/pages.md): Create new pages, edit existing content, and organize documentation structure in the Mintlify web editor with drag-and-drop page management.
- [Publish changes in the web editor](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/editor/publish.md): Save drafts, stage changes, and publish updates to your live documentation site from the Mintlify web editor with one-click deployment.
- [How to create accessible documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/accessibility.md): Create accessible documentation following WCAG guidelines with semantic HTML, keyboard navigation, alt text, and inclusive content practices.
- [Tutorial: Build an in-app documentation assistant](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/assistant-embed.md): Build and embed an in-app documentation assistant that answers user questions with cited information from your Mintlify documentation site.
- [Tutorial: Auto-update documentation when code changes](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/automate-agent.md): Set up automated documentation updates triggered by code changes using the Mintlify agent API with GitHub Actions or n8n workflow examples.
- [Work with branches](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/branches.md): Create and manage documentation branches to preview changes, collaborate with teammates, and merge updates before publishing to production.
- [Write documentation with Claude Code](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/claude-code.md): Configure Claude Code with CLAUDE.md project instructions to write, review, and update your Mintlify documentation following your style guide.
- [Configure automerge for GitHub Apps](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/configure-automerge.md): Set up GitHub workflows to automatically merge Mintlify pull requests by adding the Mintlify bot to your repository's ruleset bypass list.
- [Documentation content templates](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/content-templates.md): Copy and modify ready-to-use MDX templates for how-to guides, tutorials, concept explanations, and API reference pages in your documentation.
- [Documentation content types](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/content-types.md): Choose the right documentation type for each page using the Diátaxis framework: tutorials, how-to guides, reference, and explanation.
- [Write documentation with Cursor](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/cursor.md): Configure Cursor with project rules to write Mintlify documentation that follows your style guide, component usage, and MDX conventions.
- [Headless docs with a custom frontend](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/custom-frontend.md): Build a headless documentation frontend with Astro while using Mintlify for content management, AI-powered search, and assistant features.
- [Build custom page layouts](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/custom-layouts.md): Use page modes and components to build custom landing pages, marketing pages, and other non-standard layouts in your Mintlify documentation.
- [Create developer documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/developer-documentation.md): Build developer documentation that helps engineers integrate with your APIs, SDKs, and tools, including quickstarts, references, and guides.
- [GEO guide: Optimize docs for AI search and answer engines](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/geo.md): Optimize your documentation for AI-powered answer engines like ChatGPT, Perplexity, and Google AI Overviews with Generative Engine Optimization techniques.
- [Git concepts for documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/git-concepts.md): Learn Git version control fundamentals for docs-as-code workflows, including repositories, branches, commits, and pull request collaboration.
- [Create a help center](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/help-center.md): Build a self-service help center on Mintlify that helps customers find answers, reduces support ticket volume, and scales with your team.
- [How to measure and improve documentation quality](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/improving-docs.md): Use analytics, user feedback, and content audits to identify documentation gaps and improve the pages that matter most to your users.
- [Guides](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/index.md): Browse guides on documentation best practices, content strategy, SEO optimization, accessibility, and docs-as-code workflows for your team.
- [How to set up multi-language documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/internationalization.md): Set up multi-language documentation with locale-based routing, language switcher navigation, and translated content to reach global audiences.
- [Create a knowledge base](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/knowledge-base.md): Host your internal knowledge base on Mintlify to consolidate information for your team, improve search, and reduce maintenance burden.
- [How to link documentation pages effectively](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/linking.md): Create internal links, anchor links, and deep links in your documentation, and maintain link integrity with redirects and broken link checks.
- [How to maintain documentation over time](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/maintenance.md): Keep documentation accurate and up-to-date with review schedules, ownership models, automated checks, and content lifecycle practices.
- [How to use images, screenshots, and videos in documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/media.md): Learn when and how to use screenshots, GIFs, and videos in documentation with guidance on format selection, alt text, and long-term maintenance.
- [Migrating MDX API pages to OpenAPI navigation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/migrating-from-mdx.md): Migrate your manually written MDX API pages to automated OpenAPI-generated documentation with flexible navigation and endpoint grouping.
- [How to structure documentation navigation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/navigation.md): Design documentation navigation that helps users find what they need with clear information architecture, logical grouping, and validated structure.
- [How to improve documentation SEO](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/seo.md): Improve your documentation's search engine rankings with page titles, keyword research, internal linking, and technical SEO techniques.
- [How to write technical documentation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/style-and-tone.md): Write clear, consistent technical documentation with practical guidance on voice, structure, terminology, and tone for developer and product docs.
- [How to understand your documentation audience](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/understand-your-audience.md): Define your documentation audience, research their goals and knowledge level, and apply those insights to write content that helps them succeed.
- [Write documentation with Windsurf](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/guides/windsurf.md): Configure Windsurf Cascade with workspace rules and memories to write Mintlify documentation that follows your style guide and MDX standards.
- [Introduction](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/index.md): Mintlify is an AI-native documentation platform built for developers, with beautiful defaults, interactive API playgrounds, and smart search.
- [Adobe Analytics](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/adobe.md): Integrate Adobe Analytics with your Mintlify documentation site using Adobe Experience Platform Launch tags for detailed usage tracking.
- [Amplitude](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/amplitude.md): Integrate Amplitude analytics with your Mintlify documentation site to track user behavior, page views, and content engagement metrics.
- [Clarity](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/clarity.md): Integrate Microsoft Clarity with your Mintlify documentation site to capture session recordings, heatmaps, and user interaction analytics.
- [Clearbit](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/clearbit.md): Integrate Clearbit with your Mintlify documentation to enrich visitor data, identify visiting companies, and track enterprise engagement.
- [Fathom](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/fathom.md): Integrate Fathom Analytics with your Mintlify documentation for privacy-focused, GDPR-compliant visitor tracking with a simple site ID setup.
- [Google Analytics 4](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/google-analytics.md): Integrate Google Analytics 4 with your Mintlify documentation to track visitor behavior, page views, and content engagement with your GA4 ID.
- [Google Tag Manager](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/google-tag-manager.md): Integrate Google Tag Manager with your Mintlify documentation to manage analytics tags, conversion tracking, and marketing events centrally.
- [Heap](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/heap.md): Integrate Heap analytics with your Mintlify documentation site to automatically capture user interactions and events for behavioral analysis.
- [Hightouch](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/hightouch.md): Integrate Hightouch with your Mintlify documentation to sync analytics data for audience activation, segmentation, and downstream tool routing.
- [Hotjar](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/hotjar.md): Integrate Hotjar with your Mintlify documentation site to capture session recordings, heatmaps, and user feedback for experience insights.
- [LogRocket](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/logrocket.md): Integrate LogRocket with your Mintlify documentation to replay user sessions, monitor frontend errors, and debug interaction issues in detail.
- [Mixpanel](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/mixpanel.md): Integrate Mixpanel with your Mintlify documentation site to track product analytics, user behavior funnels, and content engagement events.
- [Analytics integrations](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/overview.md): Connect your Mintlify documentation to analytics platforms like Google Analytics, Mixpanel, PostHog, and more to track visitor engagement.
- [Pirsch](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/pirsch.md): Integrate Pirsch with your Mintlify documentation for GDPR-compliant, cookie-free analytics that tracks page views without collecting personal data.
- [Plausible](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/plausible.md): Integrate Plausible Analytics with your Mintlify documentation for lightweight, privacy-respecting visitor tracking without cookies or consent banners.
- [PostHog](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/posthog.md): Integrate PostHog with your Mintlify documentation site to track product analytics, feature usage, and user behavior with your API key.
- [Segment](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/analytics/segment.md): Integrate Segment with your Mintlify documentation to route analytics events to downstream tools like warehouses, CRMs, and marketing platforms.
- [Osano](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/privacy/osano.md): Integrate Osano with your Mintlify documentation site to manage cookie consent banners, privacy preferences, and regulatory compliance.
- [Privacy integrations](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/privacy/overview.md): Connect your Mintlify documentation site to privacy platforms like Osano to manage cookie consent, compliance banners, and user preferences.
- [Speakeasy](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/sdks/speakeasy.md): Display autogenerated SDK code samples from Speakeasy in your API playground with multi-language examples for Python, TypeScript, Go, and more.
- [Stainless](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/sdks/stainless.md): Display autogenerated SDK code samples from Stainless in your API playground with type-safe examples across Python, TypeScript, and other SDKs.
- [Front](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/support/front.md): Integrate Front chat with your Mintlify documentation site so visitors can start customer support conversations directly from your docs pages.
- [Intercom](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/support/intercom.md): Integrate the Intercom chat widget into your Mintlify documentation site to provide real-time customer messaging, support, and onboarding help.
- [Support integrations](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/integrations/support/overview.md): Connect your Mintlify documentation to support platforms like Intercom and Front so visitors can get live help directly from your docs pages.
- [Migrate to Mintlify](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/migration.md): Migrate your documentation to Mintlify from Docusaurus, ReadMe, GitBook, or another platform with step-by-step instructions and CLI tooling.
- [Analytics](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/optimize/analytics.md): Track documentation analytics in the Mintlify dashboard to understand page views, visitor trends, search queries, and content effectiveness.
- [Feedback](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/optimize/feedback.md): Monitor user satisfaction with built-in feedback widgets, page ratings, and thumbs up/down reactions to identify documentation improvement areas.
- [PDF exports](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/optimize/pdf-exports.md): Export your entire documentation site as a single PDF with a navigable table of contents for offline reading, sharing, and print distribution.
- [Search boost](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/optimize/search-boost.md): Bias your documentation site's in-product search ranking toward specific pages or sections by setting a boost multiplier in frontmatter or your `docs.json` navigation.
- [SEO](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/optimize/seo.md): Configure meta tags, Open Graph properties, canonical URLs, and page-level SEO settings to improve your documentation's search engine ranking.
- [Hidden pages](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/hidden-pages.md): Hide documentation pages from the sidebar navigation while keeping them accessible via direct URL, search, or AI assistant for special use cases.
- [Exclude files from publishing](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/mintignore.md): Exclude specific files and directories from your published documentation using a .mintignore file with glob patterns, similar to .gitignore syntax.
- [Navigation](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/navigation.md): Configure your documentation site navigation with groups, pages, dropdowns, tabs, and anchors in docs.json to build a sidebar structure.
- [Pages](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/pages.md): Configure page metadata, titles, descriptions, icons, and layout modes using YAML frontmatter properties at the top of your MDX documentation.
- [Global settings](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/settings.md): Configure your Mintlify documentation site with docs.json, the required configuration file that controls navigation, appearance, integrations, and more.
- [API settings](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/settings-api.md): Configure OpenAPI and AsyncAPI specs, the interactive API playground, SDK code examples, and authentication settings in your docs.json file.
- [Appearance and branding](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/settings-appearance.md): Configure theme, colors, logo, favicon, fonts, and background in docs.json to control the visual identity of your documentation site.
- [Integrations](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/settings-integrations.md): Connect analytics platforms, chat widgets, and third-party services to your Mintlify documentation site through the docs.json integrations config.
- [docs.json schema reference](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/settings-reference.md): Complete reference for every docs.json configuration property with types, default values, descriptions, and usage examples for your docs site.
- [SEO and search](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/settings-seo.md): Configure SEO settings in docs.json including site description, search engine indexing, meta tags, search bar placeholder, and page timestamps.
- [Site structure](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/organize/settings-structure.md): Configure navbar, navigation groups, footer links, banner, contextual menu, redirects, and other structural elements in your docs.json file.
- [Quickstart](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/quickstart.md): Get started with Mintlify by deploying your documentation site in minutes and making your first content change with the web editor or Git.
- [What is Mintlify?](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/what-is-mintlify.md): Mintlify is a documentation platform designed for developers and AI, with smart search, interactive API playgrounds, and built-in analytics.

## OpenAPI Specs

- [openapi](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/openapi.json)
- [discovery-openapi](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/discovery-openapi.json)
- [analytics.openapi](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/analytics.openapi.json)
- [admin-openapi](https://mintlify-mintlify-agent-cursor-1777414560.mintlify.app/admin-openapi.json)