Database endpoints
Delete a webhook
Deletes a webhook registration, so later deliveries to that hook are refused.
DELETE /v1/tenants/{tenant}/webhooks/{hook_id}
- Identify the hook registrationCheck its exact ID.
- Delete the registrationRemove the hook's saved configuration.
- Refuse later deliveriesFuture requests to that hook are no longer accepted.
Before you start
Use your database bearer token.
Use the ID of the registration to remove. Later deliveries to that hook will be refused.
Path parameters
| Field | Type | Required |
|---|---|---|
tenant | string | Required |
hook_id | string | Required |
Headers
| Field | Type | Required | Description |
|---|---|---|---|
x-oc-db-user | string | Optional | Acting database user (role, grant and row-policy checks). Send with x-oc-db-key. |
x-oc-db-key | string | Optional | API key of the x-oc-db-user user. |
Read the result
The response identifies the deleted registration. Future deliveries to that hook are refused; this does not remove rows written by earlier deliveries.
Response statuses
HTTP status reference
| Status | What to do |
|---|---|
| 200 | OK |
| 400 | Correct the request before retrying. |
| 401 | Check the credential and Authorization header. |
| 402 | Check feature access or available credits. |
| 403 | Check tenant access, roles and permissions. |
| 404 | Check the resource ID and API route. |
| 429 | Honor Retry-After when present; back off. |
| 500 | Check the outcome before retrying a write. |
| 503 | Honor Retry-After when present; check write outcomes. |