Skip to content

Update documentation for Meilisearch v1.50.0#3632

Draft
qdequele wants to merge 2 commits into
mainfrom
update/v1.50
Draft

Update documentation for Meilisearch v1.50.0#3632
qdequele wants to merge 2 commits into
mainfrom
update/v1.50

Conversation

@qdequele

Copy link
Copy Markdown
Member

Description

Automated documentation update for Meilisearch v1.50.0 (released 2026-07-20).

Changes made

OpenAPI spec update

  • Updated assets/open-api/meilisearch-openapi.json to v1.50.0
  • Regenerated assets/open-api/meilisearch-openapi-mintlify.json

New route: DELETE /dynamic-search-rules

  • Added cURL code sample for DELETE /dynamic-search-rules in .code-samples.meilisearch.yaml
  • Added route to the Search Rules group in config/navigation.json

Changelog

  • Added v1.50 entry covering breaking changes (Dynamic Search Rules API revamp, federated document fetch across shards), new wildcard facet support, and bug fixes

Bug fix: duplicate YAML key

  • Removed a duplicate post_render_template_1 key that was incorrectly appended at the end of .code-samples.meilisearch.yaml by a previous automation run

Issues encountered during automation

GitHub API rate limiting and download restrictions
The fetch-meilisearch-openapi-file script failed because:

  1. GH_TOKEN=proxy-injected was set in the environment, causing GitHub API to reject the token with 401
  2. Unsetting it hit the unauthenticated rate limit (60 req/h, already exhausted by the shared IP)

The OpenAPI file was downloaded directly from the release asset redirect URL obtained via the proxy-compatible fetch mechanism.

SDK code samples returning 404
The generate-mintlify-openapi-file script warns that all SDK repos return 404 for their .code-samples.meilisearch.yaml files. This is expected: the SDKs have not yet added samples for many v1.50 features. No SDK samples were invented.

Changelog generation skipped (no ANTHROPIC_API_KEY)
The generate-changelog script requires ANTHROPIC_API_KEY. The .env file was not present in this environment and no API key was available. The changelog entry was written manually from the GitHub release notes.

Still to check

  • Review the manually-written v1.50 changelog entry for tone and accuracy against the full release notes
  • Verify that the DELETE /dynamic-search-rules route placement in navigation is correct (currently placed between POST /dynamic-search-rules and GET /dynamic-search-rules/{uid})
  • Confirm no capability pages need updating for the wildcard facets feature or the Dynamic Search Rules API revamp
  • Fix GH_TOKEN=proxy-injected issue for future automation runs (the env var causes 401 when passed to GitHub API)
  • SDK teams should add code samples for the new routes once their SDKs support v1.50

Checklist

  • Did you use any AI tool while implementing this PR (code, tests, docs, etc.)? Yes, this PR was fully generated by Claude Code (automated scheduled run).
  • Have you made sure that the title is accurate and descriptive of the changes?

Generated by Claude Code

- Update OpenAPI spec to v1.50.0 (new DELETE /dynamic-search-rules route)
- Add cURL code sample for DELETE /dynamic-search-rules
- Add DELETE /dynamic-search-rules to navigation (config/navigation.json)
- Fix duplicate post_render_template_1 key in .code-samples.meilisearch.yaml
- Add v1.50 changelog entry (breaking changes, new features, bug fixes)
@coderabbitai

coderabbitai Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 2e0e7ea2-3aa3-4e2d-a7d6-1724cb4b8569

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch update/v1.50

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
meilisearch-documentation 🟢 Ready View Preview Jul 20, 2026, 10:19 AM

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

The POST /render-template summary changed from 'Render documents with POST'
to 'Render template' in v1.50, changing its Mintlify-generated URL from
/reference/api/template/render-documents-with-post
to /reference/api/template/render-template
@mintlify

mintlify Bot commented Jul 20, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
meilisearch-documentation 🟡 Building Jul 20, 2026, 10:17 AM

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

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.

2 participants