Skip to main content
PUT
/
v1
/
cwobject
/
bucket
/
settings
Set bucket settings
curl --request PUT \
  --url https://api.coreweave.com/v1/cwobject/bucket/settings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "bucketName": "<string>",
  "settings": {
    "auditLoggingEnabled": true
  }
}
'
{
  "settings": {
    "auditLoggingEnabled": true
  }
}

​
gRPC method: SetBucketSettings

Configures bucket settings that are not exposed by the S3-compatible API. Currently supports toggling per-bucket audit logging via settings.auditLoggingEnabled.
data.json
{
  "bucketName": "my-bucket",
  "settings": {
    "auditLoggingEnabled": true
  }
}
Example request
curl -X PUT https://api.coreweave.com/v1/cwobject/bucket/settings \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer {API_ACCESS_TOKEN}" \
       -d @data.json

Authorizations

​
Authorization
string
header
default:Bearer {API_ACCESS_TOKEN}
required

CoreWeave API access token sent as a bearer token in the Authorization header (the value is prefixed with Bearer). Used by every operation except the SAML/OIDC token-exchange endpoints (anonymous) and the container credentials GET (which uses ContainerCredentialsAuth).

Body

application/json

Inputs for configuring per-bucket settings managed through the AI Object Storage API.

​
bucketName
string

The name of the bucket to configure.

​
settings
object

The new bucket settings to apply.

Response

OK

The bucket settings after the update is applied.

​
settings
object

The bucket settings now in effect.

Last modified on June 25, 2026