docs(docs/ai-coder): deprecate env-based AI Bridge provider config - #24898
#24898Closed
dannykopping wants to merge 1 commit into
dk/aibridge-providers-chatd-plumbingcoder/coder:dk/aibridge-providers-chatd-plumbingfrom
dk/aibridge-providers-deprecate-envcoder/coder:dk/aibridge-providers-deprecate-envCopy head branch name to clipboard
Closed
docs(docs/ai-coder): deprecate env-based AI Bridge provider config#24898dannykopping wants to merge 1 commit intodk/aibridge-providers-chatd-plumbingcoder/coder:dk/aibridge-providers-chatd-plumbingfrom dk/aibridge-providers-deprecate-envcoder/coder:dk/aibridge-providers-deprecate-envCopy head branch name to clipboard
dannykopping wants to merge 1 commit into
dk/aibridge-providers-chatd-plumbingcoder/coder:dk/aibridge-providers-chatd-plumbingfrom
dk/aibridge-providers-deprecate-envcoder/coder:dk/aibridge-providers-deprecate-envCopy head branch name to clipboard
Conversation
Docs preview📖 View docs preview for |
This was referenced May 1, 2026
Contributor
Author
|
Warning This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
This stack of pull requests is managed by Graphite. Learn more about stacking. |
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 1, 2026 18:34
e6263e1 to
c0ca02a
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 1, 2026 18:34
7c002bf to
181fbab
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 1, 2026 19:24
c0ca02a to
9d381bb
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 1, 2026 19:24
181fbab to
f5cada2
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 13, 2026 15:19
9d381bb to
ebe85d2
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 13, 2026 15:22
f5cada2 to
235dbe2
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 14, 2026 10:57
ebe85d2 to
f50344a
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 14, 2026 10:57
235dbe2 to
00a44ab
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 14, 2026 11:23
f50344a to
fe2d5e5
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 14, 2026 11:23
00a44ab to
5b7999f
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 14, 2026 11:41
fe2d5e5 to
42d6c00
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
2 times, most recently
from
May 14, 2026 13:20
a40c13d to
4e30ce3
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 14, 2026 13:20
42d6c00 to
d57f04a
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 14, 2026 13:38
4e30ce3 to
f99cef6
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
2 times, most recently
from
May 14, 2026 14:13
5d9e052 to
59d051d
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
2 times, most recently
from
May 15, 2026 11:39
d706c4b to
be0e216
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-pool-reload
branch
from
May 15, 2026 11:39
59d051d to
0268595
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 15, 2026 13:16
be0e216 to
31df373
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 18, 2026 16:34
1aa13bc to
9ca1546
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 18, 2026 16:41
b78ec1c to
d012b70
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
2 times, most recently
from
May 19, 2026 10:41
36424ab to
b82947f
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 19, 2026 10:41
d012b70 to
aef956b
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 19, 2026 11:39
b82947f to
6501ec5
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 19, 2026 11:39
aef956b to
000e627
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 19, 2026 12:52
6501ec5 to
edf9cda
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 19, 2026 12:52
000e627 to
51eff19
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 19, 2026 13:03
51eff19 to
9fdd52f
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 19, 2026 13:03
edf9cda to
50471c3
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 19, 2026 13:22
9fdd52f to
21d0426
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 19, 2026 13:22
50471c3 to
6273989
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 20, 2026 08:39
21d0426 to
27129d6
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 20, 2026 08:39
6273989 to
dee1635
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 20, 2026 12:23
27129d6 to
f91ad41
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
2 times, most recently
from
May 20, 2026 12:46
6a2e247 to
e3cc4e3
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 20, 2026 12:47
f91ad41 to
383984d
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 20, 2026 15:05
e3cc4e3 to
ab5f744
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 20, 2026 15:05
383984d to
02f7de8
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-chatd-plumbing
branch
from
May 20, 2026 15:34
ab5f744 to
554e36a
Compare
dannykopping
force-pushed
the
dk/aibridge-providers-deprecate-env
branch
from
May 20, 2026 15:35
02f7de8 to
c6dcfce
Compare
This was referenced May 21, 2026
…eys API
Adds a deprecation banner under the 'Configure Providers' section
explaining that environment-driven provider configuration is now
reconciled into the database-backed ai_providers table at startup and
that the recommended way to manage providers going forward is the
/api/v2/aibridge/providers HTTP API.
Documents the new providers/keys split:
- POST /api/v2/aibridge/providers no longer carries an api_key
field; provider rows are now created first, and keys are
attached via POST /api/v2/aibridge/providers/{name}/keys.
- The keys sub-resource (GET/POST/DELETE) is the canonical place
to manage bearer tokens, with multi-key failover (oldest key
wins, future versions will rotate on 401/quota errors) and
rotation semantics (add new, then delete old).
- Bedrock-routed Anthropic providers have zero keys; their AWS
credentials live in the encrypted settings.bedrock_access_key
and settings.bedrock_access_key_secret because Bedrock
authenticates via SigV4 rather than a bearer token. POST keys
against a Bedrock provider returns 400.
- Key add and delete also publish on ai_providers_changed so the
runtime pool reloads.
Marks the indexed CODER_AIBRIDGE_PROVIDER_<N>_* form as deprecated in
its own subsection heading and points readers at the API.
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 join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Disclaimer: implemented by a Coder Agent using Claude Opus 4.7
Part of the implementation of RFC: Common AI Provider Configs (AIGOV-201).
What this PR does
Updates
docs/ai-coder/ai-gateway/setup.mdto reflect the new database-backed provider configuration:CODER_AIBRIDGE_OPENAI_*,CODER_AIBRIDGE_ANTHROPIC_*,CODER_AIBRIDGE_BEDROCK_*, and indexedCODER_AIBRIDGE_PROVIDER_<N>_*env vars are deprecated. They still work and are seeded into theai_providersdatabase table on startup.curlexamples for creating OpenAI and Bedrock-routed Anthropic providers, documenting the discriminated_type/_versionsettingsshape and theai_providers_changedpubsub-driven hot-reload.No code changes.