Agent skill sync with docs: mint dev --signed-in, OpenAPI 3.2

[mintlify]

Syncs the agent skill with two merged docs changes. CLI reference: adds the mint dev --signed-in flag. Without --signed-in or --groups, the preview shows the signed-out view.
API docs reference: OpenAPI 3.2 is now a supported spec version and is backward compatible with 3.1. File uploads and webhooks apply to 3.1 and 3.2. A new "Nested groups from tag hierarchies" section covers tag parent, kind and summary, how operations with several tags are placed, the x-mint.metadata tag override and tag-tree validation.
This complements the open sync in #7705. The existing sync workflow distributes the skill after merge. npm test, npm run check and npm run build didn't run because npm is blocked here, so please run them in CI or locally before merging. git diff --check and mint broken-links passed.
Sources: document mint dev --signed-in flag, Document OpenAPI 3.2 support

---

Note

Low Risk
Documentation-only changes to agent skill reference files; no runtime or application code.

Overview
Syncs the Mintlify agent skill reference with product docs: CLI and API documentation updates only.

mint dev now documents --signed-in, which previews the site as a signed-in reader with no groups. Without --signed-in or --groups, local preview defaults to the signed-out view.

OpenAPI reference expands for 3.2: supported spec versions (including 3.1 → 3.2 compatibility), a new nested groups from tag hierarchies section (parent, kind, summary, badge pills, placement rules, validation), and wording updates for file uploads and webhooks (3.1+ / 3.1 and 3.2).

^{Reviewed by Cursor Bugbot for commit 952cac3. 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	🟢 Ready	View Preview	Oct 4, 2026, 4:10 PM

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