Update AI feature docs and fix assistant API links

[mintlify]

Summary

• Fix broken cross-links between assistant message v1 and v2 API pages across all locales (en, fr, es, zh) — links used /api-reference/ prefix instead of the canonical /api/ path
• Document /.well-known/llms.txt route alongside the existing /llms.txt path
• Update llms.txt example to reflect actual generated output (.md suffix on page links, separate OpenAPI Specs and AsyncAPI Specs sections)
• Document automatic llms.txt discovery via HTTP Link and X-Llms-Txt headers
• Document Accept: text/markdown content negotiation for markdown export
• Document skills discovery endpoints (/.well-known/skills/index.json and /.well-known/skills/{name}/skill.md)
• Remove outdated "caching disabled" note from reverse proxy guidance in skill.md pages

---

Note

Low Risk
Low risk documentation-only updates; main risk is minor user confusion if any endpoint paths or headers are misstated.

Overview
Updates AI feature docs to better support tool discovery and Markdown consumption.

ai/llmstxt.mdx now documents .well-known hosting for llms.txt, discovery via Link/X-Llms-Txt headers, and refreshes the example output to match generated behavior (page links with .md, separate OpenAPI/AsyncAPI sections). ai/markdown-export.mdx adds content negotiation guidance via Accept: text/markdown/text/plain, and ai/skillmd.mdx documents /.well-known/skills/ discovery endpoints while removing the outdated “caching disabled” reverse-proxy note.

Fixes cross-links between assistant message v1/v2 pages to use the canonical /api/... paths instead of /api-reference/....

^{Written by Cursor Bugbot for commit 3a6d018. This will update automatically on new commits. Configure here.}

[mintlify-development]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
userauth	🟢 Ready	View Preview	Mar 17, 2026, 10:39 PM