* docs: boost search ranking for single-word title pages
Apply `boost: 3` to English pages whose H1 / frontmatter title is a single word (e.g. "Assistant", "Quickstart", "Cards"). Short titles tend to be canonical landing pages for a topic, so users searching the exact term should land on them first.
* docs: drop boost on websocket-playground stub to keep canonical Playground ranking
`api-playground/websocket-playground.mdx` is an auto-generated AsyncAPI stub with no body content but shares the title "Playground" with `api-playground/overview.mdx`. Boosting both equally diluted the canonical overview page in search for the query "playground". Drop the boost on the stub.
* Improve SEO metadata: fix titles, descriptions, and remove redundant OpenAPI descriptions
- Remove description frontmatter from 19 API pages where the OpenAPI spec already supplies the description
- Fix 2 titles that exceeded 60 characters (content-templates, content-types)
- Improve 15 descriptions that were too short (<130 chars) or too long (>160 chars) to target 130-155 characters
- All descriptions are unique and include relevant search terms
Generated-By: mintlify-agent
* re-add API descriptions
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
* Apply suggestion from @ethanpalm
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
* Improve SEO descriptions across 47 pages
Curated descriptions from two bot-generated PRs (#3908, #3949),
selecting the best approach for each page:
- Added missing title and description frontmatter to 10 API reference pages
- Benefit-focused descriptions for integration pages (not implementation-heavy)
- Accurate REST-aligned titles for API endpoints (Export, List, Trigger, etc.)
- Expanded short descriptions to 50–160 character range throughout
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* copyedit
* Update custom-domain.mdx
* Fix analytics API page titles to match spec summaries
"Export" was inaccurate — spec uses "Get" for both endpoints.
Also updated descriptions to use "Retrieve" for consistency.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* Fix broken links and improve keyword coverage
- Fix API reference links using incorrect /api-reference/ path (should be /api/)
- Add missing period to agent API link
- Add relevant keywords to installation and deployments pages
- Specify Node.js version in troubleshooting section
* Apply suggestion from @tembo[bot]
Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>
---------
Co-authored-by: Mintlify Agent <agent@mintlify.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: tembo[bot] <208362400+tembo[bot]@users.noreply.github.com>
* Split assistant message into separate v1 and v2 pages
- Revert create-assistant-message.mdx to v1 content with updated
OpenAPI path and note pointing users to the v2 page
- Add create-assistant-message-v2.mdx for the v2 endpoint with
AI SDK v5 integration example
- Add v2 page to docs.json navigation (Assistant group)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* add v2 endpoint to discovery openAPI schema
* update v1 openapi frontmatter
* update v2 page
* add version info to v1
* remove duplicative callout
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* hidden documentation for new analytics API endpoints
* Add property descriptions to spec
* Align path description with discovery OpenAPI spec
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Align projectId description with other specs
* update bearerAuth description
---------
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* add explanation of plausible server
* add info on aligning table columns
* clarify API keys
* add example API use cases
* update link to API auth
* remove passive voice