Test Bucket Webhook

Send a test event to one of a bucket's webhook rules.

Endpoint	Method	Admin Required
`/api/v1/buckets/:bucketName/notifications/:ruleId/test`	POST	No

Queues an s3:TestEvent message for delivery to a single webhook rule, so you can confirm the endpoint is reachable and (if a secret is set) that signature verification works - without performing a real object operation. The test message uses AWS's flat s3:TestEvent shape rather than the Records array of a real event.

Path Parameters

bucketName

string required

The name of the bucket.

ruleId

string required

The UUID of the rule to test (from Get Bucket Webhooks).

Response

202 Accepted - the test event has been queued for delivery. Delivery happens asynchronously and follows the same retry behavior as real events.

Test message format

{
    "Service": "Alarik S3",
    "Event": "s3:TestEvent",
    "Time": "2026-07-02T15:27:42.503Z",
    "Bucket": "my-bucket",
    "RequestId": "…",
    "HostId": "…"
}

Errors

Status	Reason
`400`	Missing bucket name or invalid rule id
`404`	Bucket or rule not found (or bucket not owned by you)

Set Bucket Webhooks

Replace the webhook notification rules of a bucket you own.

Create Bucket

Create a new bucket for your account.