[mintlify]

Teaches the agent skill the new slug option on openapi objects ("summary" default or "operationId"), so agents can configure operationId-based endpoint URLs. Skill-only: the public page and mint instructions are covered by #8398.

Based on a merged change that lets docs.json derive generated endpoint slugs from each operation's operationId.

---

Note

Low Risk
Skill-only documentation update with no runtime, config, or product code changes.

Overview
Documents the slug field on object-form openapi navigation/config entries in the Mintlify agent skill API reference (api-docs.md).

Agents are now told they can set slug to "operationId" (instead of the default "summary") so auto-generated endpoint page URLs come from each operation's operationId, with an example JSON snippet alongside the existing source and directory options.

^{Reviewed by Cursor Bugbot for commit 043ddef. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

Project	Status	Preview	Updated
Mintlify Docs	🟢 Ready	View Preview	Nov 11, 2026, 12:32 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

[github-actions]

This PR changes the Mintlify skill but no mint instructions topic. Agents read both, so check whether the matching topic in mint-instructions/ needs the same change. If not, ignore this comment.

Changed skill file	Likely topics
agent-context/context/skills/mintlify/reference/api-docs.md	api-docs, api-docs/sdk