docs(docs/ai-coder): deprecate env-based AI Bridge provider config#24898
Closed
dannykopping wants to merge 1 commit into
Closed
docs(docs/ai-coder): deprecate env-based AI Bridge provider config#24898dannykopping wants to merge 1 commit into
dannykopping wants to merge 1 commit into
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. |
e6263e1 to
c0ca02a
Compare
7c002bf to
181fbab
Compare
c0ca02a to
9d381bb
Compare
181fbab to
f5cada2
Compare
9d381bb to
ebe85d2
Compare
f5cada2 to
235dbe2
Compare
ebe85d2 to
f50344a
Compare
235dbe2 to
00a44ab
Compare
f50344a to
fe2d5e5
Compare
00a44ab to
5b7999f
Compare
fe2d5e5 to
42d6c00
Compare
a40c13d to
4e30ce3
Compare
42d6c00 to
d57f04a
Compare
4e30ce3 to
f99cef6
Compare
5d9e052 to
59d051d
Compare
d706c4b to
be0e216
Compare
59d051d to
0268595
Compare
be0e216 to
31df373
Compare
1aa13bc to
9ca1546
Compare
b78ec1c to
d012b70
Compare
36424ab to
b82947f
Compare
d012b70 to
aef956b
Compare
b82947f to
6501ec5
Compare
aef956b to
000e627
Compare
6501ec5 to
edf9cda
Compare
000e627 to
51eff19
Compare
51eff19 to
9fdd52f
Compare
edf9cda to
50471c3
Compare
9fdd52f to
21d0426
Compare
50471c3 to
6273989
Compare
21d0426 to
27129d6
Compare
6273989 to
dee1635
Compare
27129d6 to
f91ad41
Compare
6a2e247 to
e3cc4e3
Compare
f91ad41 to
383984d
Compare
e3cc4e3 to
ab5f744
Compare
383984d to
02f7de8
Compare
ab5f744 to
554e36a
Compare
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.