Skip to main content
PATCH
Update build storage configuration

Authorizations

Authorization
string
header
default:Bearer {API_ACCESS_TOKEN}
required

CoreWeave API access token sent as a bearer token.

Query Parameters

updateMask
string<field-mask>

Comma-separated JSON paths: enabled, mode, bucketName, location, registryNamespace, and billingReference. An omitted or empty mask replaces all writable configuration fields. A populated mask requires an existing configuration; omit the mask for initial creation. The etag is always checked independently of this mask. The wildcard * is supported only over binary protobuf (gRPC or Connect protobuf), not JSON Connect or the REST updateMask query value.

Body

application/json

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.

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.