From 5a9f0fac57e5b928ccf2fc3eb1c4c6abc47a8e39 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 10 Nov 2026 23:43:40 +0000
Subject: [PATCH] docs: note GraphQL examples in Markdown exports

---
 .../context/skills/mintlify/reference/configuration.md          | 2 +-
 ai/markdown-export.mdx                                          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/agent-context/context/skills/mintlify/reference/configuration.md b/agent-context/context/skills/mintlify/reference/configuration.md
index 20684b1d6..9c3926b4c 100644
--- a/agent-context/context/skills/mintlify/reference/configuration.md
+++ b/agent-context/context/skills/mintlify/reference/configuration.md
@@ -441,7 +441,7 @@ Under `seo`, `trailingSlash: true` emits trailing-slash URLs in canonicals, the
 ```
 
 - `instructions`: String or array, appended to every page served as Markdown to AI agents.
-- `schema`: Include the full OpenAPI or AsyncAPI spec in API pages served as Markdown. Default: `true`. GraphQL reference pages always include their schema details (arguments, return types, fields) in Markdown; `schema` does not affect them.
+- `schema`: Include the full OpenAPI or AsyncAPI spec in API pages served as Markdown. Default: `true`. GraphQL reference pages always include their schema details (arguments, return types, fields) in Markdown, and query and mutation pages also include an `Examples` section (operation, required variables, sample response); `schema` does not affect them.
 
 ## Search
 
diff --git a/ai/markdown-export.mdx b/ai/markdown-export.mdx
index a5d41dff5..e413f20e2 100644
--- a/ai/markdown-export.mdx
+++ b/ai/markdown-export.mdx
@@ -184,7 +184,7 @@ If you prefer to omit the spec from Markdown output, set `markdown.schema` to `f
 }
 ```
 
-Markdown exports of [GraphQL](/api-playground/graphql-setup) reference pages include the schema details for the page. Operation pages list the operation's signature, arguments, return type, and the fields of the return type. Type pages list the type's kind, fields, enum values, implemented interfaces, or possible types. The `markdown.schema` setting does not apply to GraphQL pages.
+Markdown exports of [GraphQL](/api-playground/graphql-setup) reference pages include the schema details for the page. Operation pages list the operation's signature, arguments, return type, and the fields of the return type. Query and mutation pages also include an `Examples` section with the same example operation, required variables, and sample JSON response that the page shows. Type pages list the type's kind, fields, enum values, implemented interfaces, or possible types. The `markdown.schema` setting does not apply to GraphQL pages.
 
 ## Custom agent instructions