Skip to content

[AI Gateway] Deprecate Universal Endpoint and consolidate into a sing…#30692

Draft
ethulia wants to merge 1 commit intoproductionfrom
ai-gateway/deprecate-universal-endpoint
Draft

[AI Gateway] Deprecate Universal Endpoint and consolidate into a sing…#30692
ethulia wants to merge 1 commit intoproductionfrom
ai-gateway/deprecate-universal-endpoint

Conversation

@ethulia
Copy link
Copy Markdown
Contributor

@ethulia ethulia commented May 7, 2026

…le unlinked reference page

Remove Universal API mentions from all AI Gateway docs while keeping a single hidden reference page (usage/universal.mdx) with a deprecation banner pointing users to the OpenAI-compatible endpoint and Dynamic Routing.

  • Consolidate timeout/retry config examples into universal.mdx
  • Add fallbacks section with cf-aig-step docs to universal.mdx
  • Remove Universal sections from request-handling.mdx
  • Remove run() binding method from worker-binding-methods.mdx
  • Remove Universal from filter tables in logging and evaluations
  • Update glossary entries to remove fallbacks.mdx references
  • Update glossary header hierarchy to remove provider-level (Universal-only)
  • Remove Universal mention from tutorial and WebSocket prose

Summary

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

…le unlinked reference page

Remove Universal API mentions from all AI Gateway docs while keeping
a single hidden reference page (usage/universal.mdx) with a deprecation
banner pointing users to the OpenAI-compatible endpoint and Dynamic
Routing.

- Consolidate timeout/retry config examples into universal.mdx
- Add fallbacks section with cf-aig-step docs to universal.mdx
- Remove Universal sections from request-handling.mdx
- Remove run() binding method from worker-binding-methods.mdx
- Remove Universal from filter tables in logging and evaluations
- Update glossary entries to remove fallbacks.mdx references
- Update glossary header hierarchy to remove provider-level (Universal-only)
- Remove Universal mention from tutorial and WebSocket prose
@github-actions github-actions Bot added product:ai-gateway AI Gateway: https://developers.cloudflare.com/ai-gateway/ size/m labels May 7, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/ai-gateway/ @abhishekkankani, @palashgo, @thebongy, @roerohan, @kathayl, @mchenco, @zeke, @superhighfives, @bfirsh, @mattrothenberg, @ethulia, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
* @cloudflare/pcx-technical-writing, @cloudflare/product-owners

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

Preview URL: https://38927163.preview.developers.cloudflare.com
Preview Branch URL: https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/ai-gateway/usage/universal/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/usage/universal/
https://developers.cloudflare.com/ai-gateway/configuration/request-handling/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/configuration/request-handling/
https://developers.cloudflare.com/ai-gateway/integrations/worker-binding-methods/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/integrations/worker-binding-methods/
https://developers.cloudflare.com/ai-gateway/glossary/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/glossary/
https://developers.cloudflare.com/ai-gateway/evaluations/set-up-evaluations/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/evaluations/set-up-evaluations/
https://developers.cloudflare.com/ai-gateway/observability/logging/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/observability/logging/
https://developers.cloudflare.com/ai-gateway/tutorials/deploy-aig-worker/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/tutorials/deploy-aig-worker/
https://developers.cloudflare.com/ai-gateway/usage/websockets-api/non-realtime-api/ https://ai-gateway-deprecate-universal-endpoint.preview.developers.cloudflare.com/ai-gateway/usage/websockets-api/non-realtime-api/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:ai-gateway AI Gateway: https://developers.cloudflare.com/ai-gateway/ size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants