Skip to main content
GET
Get build storage configuration

Authorizations

Authorization
string
header
default:Bearer {API_ACCESS_TOKEN}
required

CoreWeave API access token sent as a bearer token.

Response

OK

BuildStorageConfig is the organization's current Compose build storage configuration. Build contexts are stored under the contexts/ prefix and failed-build logs under the bob-build-logs/ prefix of the selected bucket. Existing builds retain the revision selected at admission.

enabled
boolean

Whether new builds may use this configuration. Setting false preserves existing builds and does not provision or validate storage.

mode
enum<string>

Storage ownership mode. Specify a concrete mode on initial configuration, full replacement, or an update that selects mode. BUILD_STORAGE_MODE_UNSPECIFIED is invalid in these writes. A partial update that excludes mode preserves the existing mode.

Available options:
BUILD_STORAGE_MODE_UNSPECIFIED,
BUILD_STORAGE_MODE_MANAGED,
BUILD_STORAGE_MODE_CUSTOMER_OWNED
bucketName
string

Required in CUSTOMER_OWNED mode; must be empty in MANAGED mode.

location
string

Object-storage location. Required on initial configuration/full replacement. The location of an existing managed bucket can't change.

registryNamespace
string

Customer-owned CWCR namespace for build images. Required on initial configuration and full replacement.

billingReference
string

Customer billing attribution reference. Required on initial configuration and full replacement.

etag
string

Opaque revision token. Omit only for initial configuration. Send the value returned by Get when updating; a stale value returns FAILED_PRECONDITION.

revision
string
read-only

Monotonically increasing revision, retained for existing builds.

effectiveBucketName
string
read-only

Actual bucket selected for this revision. It may still be awaiting provisioning when enabled is false.