Skip to content

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

Merged
ethulia merged 3 commits intoproductionfrom
ai-gateway/deprecate-universal-endpoint
May 8, 2026
Merged

[AI Gateway] Deprecate Universal Endpoint and consolidate into a sing…#30692
ethulia merged 3 commits 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.

ethulia added 2 commits May 7, 2026 10:06
…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://703a3ff9.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/

@ethulia ethulia marked this pull request as ready for review May 8, 2026 17:24
@ethulia
Copy link
Copy Markdown
Contributor Author

ethulia commented May 8, 2026

/bonk review this

Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue to address before merge.

Comment thread src/content/docs/ai-gateway/usage/universal.mdx Outdated
@ask-bonk
Copy link
Copy Markdown
Contributor

ask-bonk Bot commented May 8, 2026

1 issue to address before merge.

HIGHsrc/content/docs/ai-gateway/usage/universal.mdx:121
The retry configuration code block uses ```json but contains TypeScript type syntax (?:). Posted a suggestion to change the language tag to ts.

The rest of the PR is clean. Heading hierarchy is correct after the removals, links resolve properly, and the consolidation into the hidden universal.mdx reference page is consistent with the deprecation goal.

github run

Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
@ethulia ethulia merged commit 5a6c95f into production May 8, 2026
15 checks passed
@ethulia ethulia deleted the ai-gateway/deprecate-universal-endpoint branch May 8, 2026 19:26
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.

9 participants