* Clarify which API key type each endpoint requires
- Append an auth line to every operation description across all five
OpenAPI specs stating the required key type and prefix (admin mint_ vs
assistant mint_dsc_)
- Fix discovery security scheme claiming the assistant key is safe for
client-side code, contradicting the proxy guidance in api/introduction
- Expand the terse static-export security scheme description to match
the other admin specs
* Drop key prefix mentions from spec descriptions
* docs: update hosted docs domain to mintlify.site
* docs: complete mintlify.site migration across remaining pages
Updates 45 files that PR 6282 had originally changed but were
reverted by PR 6285 and not re-addressed in this PR:
- snippets/vercel-json-generator.mdx (all 4 locales): rewrite
destinations now use mintlify.site, consistent with deploy/vercel.mdx
- assistant/use.mdx: example deep-link URLs
- ai/skillmd.mdx: agent card subdomain reference
- guides/assistant-embed.mdx: docsURL code example
- guides/codex.mdx: MCP URL example
- deploy/authentication-setup.mdx: example Mintlify subdomain
- discovery-openapi.json: domain identifier URL descriptions (4 occurrences)
- integrations/privacy/osano.mdx: managed rule domain
- editor/branching-and-publishing.mdx: branch preview URL format
- customize/themes.mdx: theme demo site links
- guides/help-center.mdx: live example link
- zh/editor/collaborate.mdx: branch preview URL format
All changes mirrored across es, fr, and zh locales.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add optional scoreThreshold (0-1) parameter to discovery search endpoint
- Change pageSize type from number to integer with minimum 1, maximum 50
- Update MCP per-domain rate limit from 1,000 to 10,000 requests/hour
- Update per-user rate limit description to reflect config endpoint scope
- Applied across EN, ES, FR, ZH specs and MCP docs
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* Update API specs to match server implementation
Generated-By: mintlify-agent
* remove X-Message-Id and X-Pull-Request-Link
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@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>
* 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
* Use sentence case for endpoints
* add search endpoint
* add link to search in API intro
* rename `/chat` to `/assistant`
* make it more clear which keys are for which endpoints
* remove redundant security
* Refactor API endpoint to generate assistant messages with updated request and response structures
* Add Mintlify documentation and update API reference for assistant message generation
* Update OpenAPI specification for assistant message generation with new request structure and additional properties
* Add default values for threadId and messages in assistant message generation
* Add back the create topic and generate message pages
* fix: correct the openapi url for assistant
* Refactor API endpoint to generate assistant messages with updated request and response structures
* Add Mintlify documentation and update API reference for assistant message generation
* Update OpenAPI specification for assistant message generation with new request structure and additional properties
* Add default values for threadId and messages in assistant message generation
* Add back the create topic and generate message pages
mintlify[bot]