# UpdateBucketRequest

**public** boolean

If set to true, the bucket will be publicly accessible. Default is false.

**enable_object_acl** boolean

If set to true, per object ACL will be enabled. Default is false.

**enable_public_list_objects** boolean

If set to true, anonymous users can list objects in public buckets. Only applicable to public buckets.

**object_notifications** object

Configuration for object event notifications via webhook. Receive HTTP callbacks when objects are created, updated, or deleted in your bucket.

**Update behavior (partial updates supported):**

- **Omit field entirely**: Keeps existing settings unchanged
- **Include only `enabled`**: Toggles notifications on/off while preserving all other config
- **Include any field**: Updates specified fields, preserves others (auth not re-required)
- **Remove completely**: Send `{\"enabled\": false}` with no other fields

**Common operations:**

```json
// Enable notifications (preserves webhook, filter, auth)

{"enabled": true}

// Disable temporarily (keeps all config for later)

{"enabled": false, "webhook": "https://..."}

// Update webhook only (preserves auth, filter)

{"webhook": "https://new-endpoint.com"}

// Change auth type (replaces entire auth object)

{"auth": {"token": "new-token"}}

// Remove all notifications

{"enabled": false}
```

**Note:** Auth credentials are masked in responses. You don't need to re-send them when updating other fields.

**enabled** boolean required

Enable or disable notifications (webhook required when true)

**webhook** uri

HTTPS endpoint to receive notification events

**Example:** `https://webhook.example.com/tigris-events`

**filter** string

SQL WHERE clause to filter which objects trigger notifications (e.g., size comparisons)

**Example:** `size > 1000000`

**auth** object

Authentication credentials for webhook endpoint

**basic_user** string

Basic auth username

**basic_pass** password

Basic auth password

**token** password

Bearer token for authorization

**regions** Regions

Restricts the regions where bucket data is stored. Default is empty, which means no restrictions (global distribution).

Accepted values:

- Specific region(s): "iad", "sjc", "iad,sjc,lhr" (comma-separated)
- No restrictions (global distribution): "global"

If you want to remove existing region restrictions, you can set the value to "global".

See [https://www.tigrisdata.com/docs/objects/object_regions/](/content/docs/objects/object_regions/index.html) for more details.

UpdateBucketRequest

```json
{

"public": true,

"enable_object_acl": true,

"enable_public_list_objects": true,

"object_notifications": {

"enabled": true,

"webhook": "https://webhook.example.com/tigris-events",

"filter": "size > 1000000",

"auth": {

"basic_user": "string",

"basic_pass": "string",

"token": "string"

}

},

"regions": "string"

}
```