Chelabase
ManagementStorage

Get a storage webhook

GET
/v1/databases/{id}/storage/webhooks/{webhook_id}

One endpoint, with its failure state (never its secret).

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Database id

Formatuuid
webhook_id*string

Webhook id

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/databases/497f6eca-6276-4993-bfeb-53cbbbba6f08/storage/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "bucket": "string",  "consecutive_failures": 0,  "created_at": "2019-08-24T14:15:22Z",  "database_id": "91088904-0b92-46ad-9240-e1afa0da22df",  "disabled_reason": "string",  "enabled": true,  "enabled_since": "2019-08-24T14:15:22Z",  "events": [    "string"  ],  "failing_since": "2019-08-24T14:15:22Z",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "last_attempt_at": "2019-08-24T14:15:22Z",  "prefix": "string",  "updated_at": "2019-08-24T14:15:22Z",  "url": "string"}

Create a storage webhook POST

Registers an endpoint for the database's storage object events (every branch's, made through the storage API; changes made with SQL directly on `storage.objects` send none). Each event is POSTed as JSON, signed with `Chelabase-Signature: t=<unix>,v1=<hex HMAC-SHA256 of "<t>.<body>">`, at least once, retried with backoff for up to 24 hours. A database keeps at most 100,000 undelivered events: past that its oldest events are dropped unsent. The secret is in this response only. A database has at most 20 endpoints.

Update a storage webhook PATCH

Changes the given fields. `bucket` and `prefix` accept `null` to clear them. Enabling a disabled endpoint restarts delivery from now and clears its failure state.