Skip to content

Replace deprecated openapi-check with mint validate#5078

Closed
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/openapi-check-deprecation-1775081160
Closed

Replace deprecated openapi-check with mint validate#5078
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/openapi-check-deprecation-1775081160

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 1, 2026

Summary

Updates all references to the deprecated mint openapi-check command to use mint validate instead, following mintlify/mint#6835 which deprecates the standalone openapi-check CLI command and folds its functionality into mint validate.

Changes

  • installation.mdx: Replaced the "Check OpenAPI spec" section with a note about mint validate auto-validating OpenAPI files and a deprecation notice
  • api-playground/troubleshooting.mdx: Updated validation troubleshooting to recommend mint validate
  • api-playground/overview.mdx: Updated the OpenAPI validation tip to use mint validate
  • api-playground/openapi-setup.mdx: Updated the CLI validation reference to use mint validate
  • Applied equivalent changes to all localized docs (zh, fr, es)

Note

Low Risk
Low risk documentation-only change; main risk is minor confusion if the new guidance doesn’t match a reader’s older CLI version.

Overview
Replaces all doc references to the deprecated mint openapi-check command with mint validate. This updates the API playground setup/overview/troubleshooting pages (and their es, fr, zh translations) to recommend mint validate for OpenAPI validation.

Refreshes the installation guidance by removing the standalone openapi-check section and documenting that mint validate automatically validates OpenAPI files declared in docs.json, with a note calling out the deprecation and pointing to --disable-openapi to skip OpenAPI validation.

Written by Cursor Bugbot for commit afa252e. This will update automatically on new commits. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 1, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 1, 2026, 10:10 PM

@ethanpalm
Copy link
Copy Markdown
Collaborator

not yet merged

@ethanpalm ethanpalm closed this Apr 2, 2026
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