## Configure Object Event Notifications

Configure object event notifications on a bucket. Sends webhook requests to a URL when objects are created, updated, or deleted.

## Usage

```bash
tigris buckets set-notifications <name> [flags]
t3 b set-notifications <name> [flags]
```

## Flags

| Name         | Required | Default | Description                                                                                  |
|--------------|----------|---------|----------------------------------------------------------------------------------------------|
| `--url`     | No       | —       | Webhook URL to send notifications to (must be http or https)                              |
| `--filter`  | No       | —       | SQL WHERE clause to filter events by key (e.g. ``WHERE `key` REGEXP "^images"``)       |
| `--token`   | No       | —       | Token for webhook authentication                                                             |
| `--username`| No       | —       | Username for basic webhook authentication                                                    |
| `--password`| No       | —       | Password for basic webhook authentication                                                    |
| `--enable`  | No       | —       | Enable notifications on the bucket (uses existing config)                                   |
| `--disable` | No       | —       | Disable notifications on the bucket (preserves existing config)                            |
| `--reset`   | No       | —       | Clear all notification settings on the bucket                                               |

## Examples

```bash
# Set up webhook notifications
tigris buckets set-notifications my-bucket --url https://example.com/webhook

# With token authentication
tigris buckets set-notifications my-bucket --url https://example.com/webhook --token secret123

# With basic authentication
tigris buckets set-notifications my-bucket --url https://example.com/webhook --username admin --password secret

# Only receive notifications for keys with the prefix images/
tigris buckets set-notifications my-bucket --url https://example.com/webhook --filter 'WHERE `key` REGEXP "^images"'

# Enable existing notification config
tigris buckets set-notifications my-bucket --enable

# Disable notifications (preserves config)
tigris buckets set-notifications my-bucket --disable

# Clear all notification settings
tigris buckets set-notifications my-bucket --reset
```
