Skip to content

Model Catalog Migration 9/9: Product Pages#638

Merged
siddharthsambharia-portkey merged 5 commits intomainfrom
migration/09-product-pages
Feb 9, 2026
Merged

Model Catalog Migration 9/9: Product Pages#638
siddharthsambharia-portkey merged 5 commits intomainfrom
migration/09-product-pages

Conversation

@roh26it
Copy link
Contributor

@roh26it roh26it commented Dec 22, 2025

Model Catalog Migration - Product Pages

What's changing

Core product documentation updated for Model Catalog migration.

Files changed (19)

AI Gateway:

  • ai-gateway.mdx - Main gateway page
  • virtual-keys.mdx - Comprehensive rewrite
  • fallbacks.mdx, load-balancing.mdx, automatic-retries.mdx
  • batches.mdx, cache-simple-and-semantic.mdx, circuit-breaker.mdx

Model Catalog:

  • model-catalog.mdx - Main Model Catalog page
  • model-catalog/integrations.mdx - Integrations management
  • model-catalog/custom-models.mdx - Custom models

Administration & Enterprise:

  • administration/configure-virtual-key-access-permissions.mdx
  • enterprise-offering/budget-limits.mdx
  • enterprise-offering/org-management/api-keys-authn-and-authz.mdx

Observability:

  • observability.mdx, observability/budget-limits.mdx
  • observability/cost-management.mdx, observability/opentelemetry.mdx

Other:

  • prompt-engineering-studio.mdx

Review checklist

  • Virtual Keys page comprehensively updated
  • Model Catalog pages are the source of truth
  • Gateway feature pages use new config format
  • Admin pages reference Model Catalog correctly
  • Budget/rate limit pages are consistent

Risk: 🟠 Higher

Core product pages - these define the product's mental model.

Part of

Model Catalog Migration - Final PR in the series! 🎉

Update core product documentation:
- AI Gateway pages (fallbacks, load-balancing, retries, batches, caching)
- Virtual Keys page (comprehensive rewrite)
- Model Catalog pages (main, integrations, custom models)
- Administration & Enterprise pages
- Observability pages (budget limits, cost management)
Updated the Provider Management section to include a toggle for workspace-level configuration and clarified permission settings for Managers and Members. Added a note regarding the default restrictions for Members on managing providers.
Introduced a new section on Sticky Load Balancing, detailing its benefits, configuration, parameters, and operational mechanics. Included a JSON configuration example and highlighted caveats regarding Redis requirements for persistence across gateway instances.
- Restore W3C Trace Context Headers section in opentelemetry.mdx
- Replace virtual-keys.mdx with migration notice to Model Catalog
- Restore integration image and rename section in model-catalog.mdx
- Update virtual_keys permissions to providers permissions in api-keys-authn-and-authz.mdx
- Update retry-after headers note in automatic-retries.mdx
- Update semantic caching note in cache-simple-and-semantic.mdx

Co-authored-by: Cursor <[email protected]>
Updated the caching information to specify that **Simple** caching is available for all plans, while **Semantic** caching requires a vector database and is limited to select Enterprise plans. This change enhances clarity for users regarding caching features.
@siddharthsambharia-portkey siddharthsambharia-portkey merged commit 5e95d49 into main Feb 9, 2026
3 checks passed
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