Skip to content

docs: document Bedrock BYOK env var interpolation and region chain#1331

Merged
nikhil-factory merged 1 commit into
mainfrom
docs/bedrock-byok-env-var-interpolation
Jul 24, 2026
Merged

docs: document Bedrock BYOK env var interpolation and region chain#1331
nikhil-factory merged 1 commit into
mainfrom
docs/bedrock-byok-env-var-interpolation

Conversation

@nikhil-factory

Copy link
Copy Markdown
Contributor

Summary

Documents the previously-undocumented customModels[].bedrock config on the BYOK overview page, reflecting the feature shipped in factory-mono #15966 (resolves Linear CL-912).

Specifically:

  • Adds bedrock to the Supported Fields table.
  • Adds an AWS Bedrock section covering the bedrock object fields.
  • Documents ${VAR_NAME} interpolation for awsRegion, awsProfile, and bedrockBaseUrl (and why awsAuthRefresh/awsCredentialExport are excluded).
  • Documents the AWS default region-resolution chain (AWS_REGION -> AWS_DEFAULT_REGION -> profile region) and fail-fast behavior when no region is configured.

Notes

Left changelog/release-notes.mdx untouched since entries there are tied to specific CLI release versions.

Document the customModels bedrock config on the BYOK overview page,
covering ${VAR} interpolation for awsRegion/awsProfile/bedrockBaseUrl and
the AWS default region-chain fallback shipped in factory-mono #15966
(Linear CL-912).

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@factory-droid

factory-droid Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Droid finished @nikhil-factory's task —— View job


Security Review

Review summary

Clear, useful documentation addition for Bedrock routing and ${VAR_NAME} interpolation. One inconsistency remains between the reference table and the Bedrock example around whether baseUrl is required.

@nikhil-factory
nikhil-factory merged commit 68fd93d into main Jul 24, 2026
5 checks passed
@nikhil-factory
nikhil-factory deleted the docs/bedrock-byok-env-var-interpolation branch July 24, 2026 18:23
{
"customModels": [
{
"model": "anthropic.claude-sonnet-4-5-20250929-v1:0",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

[P1] Reconcile baseUrl requirement with the Bedrock example

The Bedrock JSON example omits baseUrl, but the Supported Fields table above still marks baseUrl as required. As written, readers who copy/paste either get an invalid config (if baseUrl is actually required in Bedrock mode) or a misleading reference table (if baseUrl is optional/ignored when bedrock is present), so please update either the table or the example to match the real requirement.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants