Document API spec file upload in web editor

[mintlify]

Summary

• Updated the web editor pages documentation to reflect that API specification files can now be uploaded directly in the editor, not just pushed via Git.
• Updated the publish page to clarify that file uploads (including API specs) are tracked as pending changes.

What shipped

The web editor now supports uploading API specification files (OpenAPI and AsyncAPI) in .json, .yaml, and .yml formats directly from the editor. Previously, updating spec files required editing them externally and pushing via Git. The publish flow was also improved with snapshot-based publishing for better reliability.

---

Note

Low Risk
Low risk documentation-only updates that clarify existing web editor behavior around API spec uploads and what counts as a pending change.

Overview
Updates web editor docs to clarify that OpenAPI/AsyncAPI spec files remain read-only for inline editing but can now be replaced by uploading a new file via the editor (editor/pages.mdx).

Clarifies in the publishing docs that file uploads, including API specification files, are tracked as pending changes (editor/publish.mdx).

^{Reviewed by Cursor Bugbot for commit 1365b7c. 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 (UTC)
mintlify	🟢 Ready	View Preview	Apr 9, 2026, 12:46 AM