feat: add /api/v2/ai-gateway API route aliases by ssncferreira · Pull Request #26475 · coder/coder

ssncferreira · 2026-06-17T16:11:16Z

Description

Registers /api/v2/ai-gateway/* as the new API path for AI Gateway, replacing /api/v2/aibridge/*. Both prefixes share the same route builder (aiBridgeRoutes) backed by a single in-memory handler, so existing /aibridge endpoints continue to work. New endpoints must be registered on the enterprise API handler under /api/v2/ai-gateway only.

Swagger annotations now point to /api/v2/ai-gateway paths with a backward-compatibility note referencing /aibridge. The legacy /aibridge routes are skipped in the swagger documentation test.

Changes

Store one raw handler (aiGatewayHandler) instead of two prefix-stripped handlers
Register /ai-gateway and /ai-gateway/proxy route aliases alongside legacy /aibridge routes
Move /aibridge/keys to /ai-gateway/keys
Update in-process transport to use /api/v2/ai-gateway prefix
Update SDK client URLs and proxy forwarding URL
Swap @Router and @Tags annotations from aibridge/AI Bridge to ai-gateway/AI Gateway
Rename user-facing error messages from "AI Bridge" to "AI Gateway"
Define consts for route prefixes (AIGatewayRootPath, AIBridgeRootPath)
Update tests and comments to use new paths

Note: the following will be addressed in follow-up PRs:

Frontend API URLs
Frontend routes and redirects
Dogfood main.tf updates
Hand-written documentation URL updates
aibridge internal comments and nits
Scale tests path updates

Refs https://linear.app/coder/issue/AIGOV-230

Generated with the assistance of Coder Agents (@ssncferreira)

ssncferreira · 2026-06-17T16:11:30Z

This stack of pull requests is managed by Graphite. Learn more about stacking.

github-actions · 2026-06-19T16:53:43Z

Docs preview

📖 View docs preview for docs/ai-coder/ai-gateway/monitoring.md

linear-code · 2026-06-22T08:48:14Z

AIGOV-230

coder-tasks · 2026-06-22T12:37:25Z

Documentation Check

Updates Needed

docs/ai-coder/ai-gateway/monitoring.md - Line 134 link to ../../reference/api/aibridge.md updated to aigateway.md.
docs/install/releases/esr-2.29-2.34-upgrade.md - Line 178 link to ../../reference/api/aibridge.md updated to aigateway.md.
docs/ai-coder/ai-gateway/clients/ (multiple files) - 39+ references to /api/v2/aibridge/ URLs across client setup guides (claude-code, cline, codex, factory, index, jetbrains, kilo-code, mux, opencode, vscode, zed). Since /api/v2/ai-gateway/ is now the canonical path, these should be updated to use the new prefix (the old routes still work but docs should point to the canonical path).
docs/ai-coder/ai-gateway/setup.md - References /api/v2/aibridge/<provider-name>/ URL pattern (line 44). Should use /api/v2/ai-gateway/.
docs/ai-coder/ai-gateway/auth.md - References /api/v2/aibridge/anthropic in a ANTHROPIC_BASE_URL example (line 53). Should use /api/v2/ai-gateway/.
docs/ai-coder/ai-gateway/providers.md - References /api/v2/aibridge/chatgpt/v1 (line 138). Should use /api/v2/ai-gateway/.
docs/ai-coder/ai-gateway/monitoring.md - References /api/v2/aibridge/sessions in a curl example (line 101). Should use /api/v2/ai-gateway/.
docs/ai-coder/ai-gateway/ai-gateway-proxy/setup.md - References /api/v2/aibridge/proxy/ca-cert.pem (lines 156, 311). Should use /api/v2/ai-gateway/.

Priority

The broken link items are now addressed. The remaining URL updates are lower priority since the legacy /aibridge routes still work, but should be updated to keep docs consistent with the new canonical /ai-gateway path. These could be done in a follow-up PR if preferred.

Automated review via Coder Agents

dannykopping

LGTM 👍

pawbana

CLI still uses old path:

coder/codersdk/aibridge.go

Line 185 in 20f54ca

    
           res, err := c.Request(ctx, http.MethodGet, "/api/v2/aibridge/sessions", nil, filter.asRequestOption(), filter.Pagination.asRequestOption())

coder/codersdk/aibridge.go

Line 200 in 20f54ca

    
           res, err := c.Request(ctx, http.MethodGet, fmt.Sprintf("/api/v2/aibridge/sessions/%s", sessionID), nil, func(r *http.Request) {

coder/codersdk/aibridge.go

Line 226 in 20f54ca

res, err := c.Request(ctx, http.MethodGet, "/api/v2/aibridge/clients", nil)

~7 usages in:

coder/site/src/api/api.ts

Line 3130 in 20f54ca

const url = getURLWithSearchParams("/api/v2/aibridge/models", options);

Some tests use old PATH, eg:

coder/enterprise/coderd/aibridge_test.go

Line 1293 in 20f54ca

url := client.URL.String() + "/api/v2/aibridge/test"

,

coder/enterprise/coderd/aibridgeproxy_test.go

Line 40 in 20f54ca

    
           req, err := http.NewRequestWithContext(ctx, http.MethodGet, client.URL.String()+"/api/v2/aibridge/proxy/ca-cert.pem", nil)

or

coder/enterprise/coderd/aibridge_reload_test.go

Line 169 in 20f54ca

url := client.URL.String() + "/api/v2/aibridge/" + providerName + "/v1/models"

nit: comment in:

coder/aibridge/provider/provider.go

Lines 26 to 27 in 20f54ca

    
           //   - https://coder.host.com/api/v2 + /aibridge        + /{provider.RoutePrefix()}  + /{bridged or passthrough route} 
        
           //     {host}                          {aibridge root}    {provider prefix}            {provider route}

Paths of UI pages are separate? eg:

coder/site/src/router.tsx

Line 705 in 20f54ca

Possible followup, update path in scale tests:

coder/scaletest/bridge/strategy.go

Line 67 in 20f54ca

switch s.provider {

nit comment:

coder/cli/server.go

Line 1117 in 20f54ca

// crossing the gated /api/v2/aibridge HTTP route. The HTTP route

ssncferreira · 2026-06-22T13:33:40Z

CLI still uses old path:

coder/codersdk/aibridge.go

Line 185 in 20f54ca

res, err := c.Request(ctx, http.MethodGet, "/api/v2/aibridge/sessions", nil, filter.asRequestOption(), filter.Pagination.asRequestOption())

coder/codersdk/aibridge.go

Line 200 in 20f54ca

res, err := c.Request(ctx, http.MethodGet, fmt.Sprintf("/api/v2/aibridge/sessions/%s", sessionID), nil, func(r *http.Request) {

coder/codersdk/aibridge.go

Line 226 in 20f54ca

res, err := c.Request(ctx, http.MethodGet, "/api/v2/aibridge/clients", nil)

~7 usages in:

coder/site/src/api/api.ts

Line 3130 in 20f54ca

const url = getURLWithSearchParams("/api/v2/aibridge/models", options);

Some tests use old PATH, eg:

coder/enterprise/coderd/aibridge_test.go

Line 1293 in 20f54ca

url := client.URL.String() + "/api/v2/aibridge/test"

,

coder/enterprise/coderd/aibridgeproxy_test.go

Line 40 in 20f54ca

req, err := http.NewRequestWithContext(ctx, http.MethodGet, client.URL.String()+"/api/v2/aibridge/proxy/ca-cert.pem", nil)

or

coder/enterprise/coderd/aibridge_reload_test.go

Line 169 in 20f54ca

url := client.URL.String() + "/api/v2/aibridge/" + providerName + "/v1/models"

nit: comment in:

coder/aibridge/provider/provider.go

Lines 26 to 27 in 20f54ca

// - https://coder.host.com/api/v2 + /aibridge + /{provider.RoutePrefix()} + /{bridged or passthrough route}

// {host} {aibridge root} {provider prefix} {provider route}

Paths of UI pages are separate? eg:

coder/site/src/router.tsx

Line 705 in 20f54ca

<Route path="/aibridge" element={<AIBridgeLayout />}>

Possible followup, update path in scale tests:

coder/scaletest/bridge/strategy.go

Line 67 in 20f54ca

switch s.provider {

nit comment:

coder/cli/server.go

Line 1117 in 20f54ca

// crossing the gated /api/v2/aibridge HTTP route. The HTTP route

Good catch, site changes will be addressed on the follow-up PR #26567
UI route paths are handled by https://linear.app/codercom/issue/AIGOV-233/update-ai-gateway-ui-copy-and-route-redirects and will be addressed on a follow-up PR.

For the CLI, tests and other nits, I can update in the context of this PR 👍

ssncferreira · 2026-06-22T17:14:04Z

@pawbana addressed the CLI, tests and other nits. There are still some other references that will be addressed in focused follow-up PRs. Updated the PR description as well with the changes meant for these follow-ups

…ming

github-actions Bot assigned ssncferreira Jun 17, 2026

ssncferreira force-pushed the ssncf/ai-gateway-api-aliases branch 5 times, most recently from e82564e to 70af39c Compare June 19, 2026 15:55

This comment has been minimized.

Sign in to view

ssncferreira force-pushed the ssncf/ai-gateway-api-aliases branch 3 times, most recently from a634eaa to 95125cc Compare June 19, 2026 16:53

ssncferreira force-pushed the ssncf/ai-gateway-api-aliases branch 2 times, most recently from 7eeb80c to f4f8875 Compare June 22, 2026 08:25

ssncferreira force-pushed the ssncf/ai-gateway-api-aliases branch from f4f8875 to 6c36692 Compare June 22, 2026 09:27

ssncferreira mentioned this pull request Jun 22, 2026

feat: update API URLs from /aibridge to /ai-gateway #26567

Merged

ssncferreira force-pushed the ssncf/ai-gateway-api-aliases branch from 6c36692 to 20f54ca Compare June 22, 2026 12:29

ssncferreira marked this pull request as ready for review June 22, 2026 12:34

ssncferreira requested review from dannykopping and pawbana June 22, 2026 12:35

dannykopping approved these changes Jun 22, 2026

View reviewed changes

Comment thread coderd/aibridged.go Outdated

Comment thread enterprise/coderd/aibridge.go

pawbana reviewed Jun 22, 2026

View reviewed changes

ssncferreira mentioned this pull request Jun 22, 2026

feat(site): move frontend routes from /aibridge to /ai-gateway with redirects #26569

Merged

ssncferreira force-pushed the ssncf/ai-gateway-api-aliases branch 2 times, most recently from 0591bf3 to b51d159 Compare June 22, 2026 16:30

ssncferreira requested a review from pawbana June 22, 2026 17:14

pawbana approved these changes Jun 23, 2026

View reviewed changes

Comment thread coderd/aibridged.go Outdated

ssncferreira added 6 commits June 23, 2026 10:57

feat: add /api/v2/ai-gateway API route aliases

a6de30c

refactor: use consts for AI Gateway route prefixes and fix handler na…

72168b2

…ming

docs: fix broken links to renamed aigateway API reference

bbd0bc4

fix: update SDK paths, tests, and comments from /aibridge to /ai-gateway

077b906

chore: minor fixes

82bd7c4

chore: address comments

7863ff7

ssncferreira force-pushed the ssncf/ai-gateway-api-aliases branch from b51d159 to 7863ff7 Compare June 23, 2026 10:58

ssncferreira merged commit 970bd73 into main Jun 23, 2026
30 of 31 checks passed

ssncferreira deleted the ssncf/ai-gateway-api-aliases branch June 23, 2026 11:15

github-actions Bot locked and limited conversation to collaborators Jun 23, 2026

Navigation Menu

Uh oh!

feat: add /api/v2/ai-gateway API route aliases - #26475

feat: add /api/v2/ai-gateway API route aliases#26475
ssncferreira merged 6 commits into
mainfrom
ssncf/ai-gateway-api-aliases

ssncferreira commented Jun 17, 2026 •

edited

Loading

Uh oh!

ssncferreira commented Jun 17, 2026 •

edited

Loading

Uh oh!

This comment has been minimized.

github-actions Bot commented Jun 19, 2026 •

edited

Loading

Uh oh!

linear-code Bot commented Jun 22, 2026

Uh oh!

coder-tasks Bot commented Jun 22, 2026 •

edited

Loading

Uh oh!

dannykopping left a comment

Uh oh!

Uh oh!

Uh oh!

pawbana left a comment

Uh oh!

ssncferreira commented Jun 22, 2026

Uh oh!

ssncferreira commented Jun 22, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	// - https://coder.host.com/api/v2 + /aibridge + /{provider.RoutePrefix()} + /{bridged or passthrough route}
	// {host} {aibridge root} {provider prefix} {provider route}

Uh oh!

Conversation

ssncferreira commented Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Changes

Uh oh!

ssncferreira commented Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment has been minimized.

github-actions Bot commented Jun 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Docs preview

Uh oh!

linear-code Bot commented Jun 22, 2026

Uh oh!

coder-tasks Bot commented Jun 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Documentation Check

Updates Needed

Priority

Uh oh!

dannykopping left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

pawbana left a comment

Choose a reason for hiding this comment

Uh oh!

ssncferreira commented Jun 22, 2026

Uh oh!

ssncferreira commented Jun 22, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

ssncferreira commented Jun 17, 2026 •

edited

Loading

ssncferreira commented Jun 17, 2026 •

edited

Loading

github-actions Bot commented Jun 19, 2026 •

edited

Loading

coder-tasks Bot commented Jun 22, 2026 •

edited

Loading