docs: add AI Gateway rebranding migration guide - #26854
Merged
Merged
Conversation
Document the AI Bridge to AI Gateway rebrand for operators: config (env/flag/YAML) aliases, HTTP API path, and Prometheus metric renames. Clarifies that old names keep working as deprecated aliases, there are no database changes, and metrics are emitted under both names today. Adds the page as the last child of the AI Gateway docs section.
Docs preview📖 View docs preview for |
Contributor
Documentation CheckUpdates Needed
Automated review via Coder Agents |
Add the indexed CODER_AI_GATEWAY_PROVIDER_<N>_<KEY> env vars (deprecated alias CODER_AIBRIDGE_PROVIDER_<N>_<KEY>) to the reference tables and a dedicated section, noting the two prefixes cannot be mixed. Add a Note column to the env var reference tables.
ssncferreira
left a comment
ssncferreira
left a comment
Contributor
There was a problem hiding this comment.
LGTM 👍 just a few comments and suggestions, but nothing blocking 🙂
- Clarify the aibridge names are retained for backward compatibility with no planned removal date, rather than implying future removal. - Move the no-breaking-changes statement into a NOTE and the new-name-only policy for future settings into an IMPORTANT callout scoped to all areas except the database. - Show the exact startup error when provider env var prefixes are mixed. - Note that AI client base URLs should be updated to the new API path.
nickvigilante
approved these changes
Jun 30, 2026
nickvigilante
left a comment
nickvigilante
left a comment
Contributor
There was a problem hiding this comment.
Approved with changes. Thanks for submitting this! 
🚀
Signed-off-by: Danny Kopping <danny@coder.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds an operator-facing migration guide for the AI Bridge to AI Gateway rebrand, as a new docs page under AI Coder > AI Gateway (last child in the section).
The guide documents:
aibridgenames still work as hidden, deprecated aliases; newai_gatewaynames are canonical. Includes full env-var mapping tables and the mechanical substitution rules./api/v2/ai-gateway; legacy/api/v2/aibridgeroutes retained.coder_aibridged_*->coder_ai_gateway_*andcoder_aibridgeproxyd_*->coder_ai_gateway_proxy_*. Both old and new names are emitted today, so dashboards keep working; guidance to migrate before the old names are removed, plus an optionalmetric_relabel_configsdrop snippet.Implements the docs/release-notes portion of AIGOV-240 (parent: AIGOV-207).
Notes
docs/manifest.jsonwithstate: ["ai governance add-on"]to match sibling pages.This PR was produced by opencode (agent) using the
anthropic/claude-opus-4-8model, under human direction and review.