Changelogs in Git

Changelog posts now sync with your git repository through bi-directional sync. We’re rolling this change out gradually and it will appear in your project soon. Read More

New Features & Improvements

Docs

  • Added an option to display a Download OpenAPI link for API Reference pages.
  • API Reference parameters now have anchor links, so you can link directly to one and find it through search.

Editor

  • Guides and basic reference pages now have a per-page toggle to hide the table of contents, overriding the project default in either direction.

Git Sync

  • Auto-generated git commit messages now use the page's title and directory instead of its slug (for example, "Created Getting Started in docs" instead of "Create doc getting-started").

Translations

  • Translated pages now also translate the text inside custom blocks and raw HTML content, not just markdown.


Bugs Eaten (by Owlbert) 🐛

API Reference

  • The JSON editor for request bodies is no longer disabled on endpoints that also have path, query, or header parameters.
  • Response rows in API Reference show a visible divider again, instead of only appearing separated on hover.
  • Nested properties that share a name with a shallower property now show their own example and default value instead of inheriting the shallower one.

AI

  • Focusing the Ask AI input on iOS Safari no longer leaves the page stuck zoomed in.
  • The public Ask AI endpoint now honors your Advanced mode setting, matching the chat widget.

Docs

  • Inline code and code blocks no longer pick up the wrong theme colors for some legacy and current projects.
  • Page descriptions on MDXish projects no longer include stray code characters in Slack unfurls, search results, and social previews.

Editor

  • The editor no longer freezes on load or lags while typing in a page containing a very long inline value, like a base64 image, inside a code block.
  • Selecting a changed API definition or page during review no longer lands on an empty pane, file rows show their file extension, and the review sidebar's row colors and headings are now consistent.

Git Sync

  • Deleted branches no longer reappear in a project's Branches settings.

Admin

  • Connecting Slack or Microsoft Teams notifications now works for any project you have access to, not just the one you're currently viewing.
  • Reconnecting Slack or Teams notifications after a disconnect no longer fails due to a stale connection.

Enterprise

  • End users now receive an email when they regain access after being re-invited, or after their access request is approved.

Translations

  • Bold and italic text no longer renders as literal asterisks in translated pages for languages without spaces between words, like Japanese and Chinese.
  • Short OAS field labels that come back untranslated are now automatically retried instead of staying in English permanently.
  • Custom blocks that fail to translate now fall back to the original English content instead of showing a missing component error.