Skip to content

Update from code changes: document OpenAPI file uploads - #6863

Open
mintlify[bot] wants to merge 5 commits into
mainfrom
mintlify/openapi-31-file-uploads-docs
Open

Update from code changes: document OpenAPI file uploads#6863
mintlify[bot] wants to merge 5 commits into
mainfrom
mintlify/openapi-31-file-uploads-docs

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Document OpenAPI 3.1 file-upload schemas and their API Playground behavior.

Changes

  • Explain contentMediaType and optional contentEncoding configuration.
  • Add a multipart/form-data request-body example and clarify supported media types.
  • Update English, Spanish, French, and Chinese setup pages.

Source change: https://github.com/mintlify/mint/pull/9788


Note

Low Risk
Documentation-only changes to MDX guides with no application or API code modified.

Overview
Adds a Configure file uploads section to openapi-setup (English, Spanish, French, and Chinese), placed before authentication setup.

The new content documents OpenAPI 3.1 multipart file fields: string schemas with binary contentMediaType, optional contentEncoding (including base64 / base64url vs binary handling), a multipart/form-data JSON example, supported MIME types, and continued support for legacy format: "binary" and format: "base64". Localized pages use a configure-file-uploads anchor; the Chinese page also expands its frontmatter description to mention file uploads.

Reviewed by Cursor Bugbot for commit ea77b6d. Bugbot is set up for automated code reviews on this repo. Configure here.

Mintlify

2 threads from 1 user in Mintlify

Review in Mintlify

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 4, 2026, 8:46 PM
tomee 🟢 Ready View Preview Aug 4, 2026, 8:46 PM

Update history

  • 2026-08-05: Appended base64 and base64url file-encoding behavior to the English, Spanish, French, and Chinese setup pages for mintlify/server#7232.

@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 4, 2026, 8:46 PM

@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 4, 2026, 8:46 PM

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

@mintlify

mintlify Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Updated localized upload terminology, SEO metadata, and prose consistency

Source PRs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant