tigris buckets set-notifications | Tigris Object Storage Documentation
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
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
# 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