Skip to content

docs: Per-model custom_headers for integration models - #1008

Open
kiran-4444 wants to merge 1 commit into
mainfrom
cursor/custom-headers-integration-models-6478
Open

docs: Per-model custom_headers for integration models#1008
kiran-4444 wants to merge 1 commit into
mainfrom
cursor/custom-headers-integration-models-6478

Conversation

@kiran-4444

Copy link
Copy Markdown
Contributor

Summary

Documents model-level custom_headers for integration models (from gateway-enterprise-node#1824 + matching Albus API validation).

  • Product: New "Per-model custom host and headers" section on Custom Models, with precedence (model > integration for headers; request-time host still wins) and a PUT /integrations/{slug}/models example
  • Integrations overview: Short note under Advanced Model Management
  • Custom hosts: Link to the per-model config path
  • Admin API: Narrative + example on Update Model Access for configurations.custom_host / configurations.custom_headers

Follow-up

The published OpenAPI schema (Portkey-AI/openapiModelConfigurations) currently only lists custom_host. Add custom_headers there so the generated reference matches this narrative.

Test plan

  • Preview Mintlify pages for custom-models, update-model-access, custom-hosts, and integrations
  • Confirm in-page anchors (#per-model-custom-host-and-headers) resolve
  • Confirm Admin API example matches Albus validation (string-to-string map)

Slack Thread

Open in Web Open in Cursor 

Cover model-level custom_headers (and precedence over integration-level)
in Model Catalog product docs and the Update Model Access Admin API page.

Co-authored-by: Chandra Kiran G <kiran-4444@users.noreply.github.com>
@kiran-4444
kiran-4444 marked this pull request as ready for review July 28, 2026 16:25
@mintlify

mintlify Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
portkey-docs 🟢 Ready View Preview Jul 28, 2026, 4:27 PM

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