Update a webhook
AuthorizationBearer <token>A personal or service access token, sent as Authorization: Bearer <token>. See access tokens.
namespace*stringThe namespace id.
webhook*stringThe webhook id.
application/json- body
A webhook to create or update.
name*stringA display name.
description*stringA free-form description.
url*stringThe endpoint events are delivered to.
enabled*booleanWhether events are delivered.
eventTypes*array<string>The event types to deliver: exact names, or a prefix followed by .*, e.g. firewall.*. At least one is required.
firewalls*array<string>Restricts firewall and package events to these firewalls. Empty means every firewall.
The updated webhook. Its signing secret is redacted.
application/json- response
A subscription that delivers namespace events to an HTTPS endpoint. Deliveries are signed following the Standard Webhooks convention.
id*stringThe webhook id.
name*stringA display name.
description?stringA free-form description.
url*stringThe endpoint events are delivered to.
enabled*booleanWhether events are delivered.
eventTypes*array<string>The event types delivered: exact names, or a prefix followed by .*, e.g. firewall.*. Event payloads are described by the webhook event schema.
firewalls*array<string>Restricts firewall and package events to these firewalls. Empty means every firewall. Other events are not affected.
secret?stringThe signing secret. Responses show a redaction placeholder.
previousSecret?stringThe signing secret before the last rotation, still accepted for 24 hours after it. Responses show a redaction placeholder.
secretRotatedAt?stringWhen the signing secret was last rotated.
date-timequarantinedUntil?stringSet when deliveries kept failing: no events are delivered until this time. Events that occur meanwhile are queued.
date-timequarantineReason?stringWhy the webhook was quarantined.
createdAt?stringWhen the webhook was created.
date-timeupdatedAt?stringWhen the webhook was last changed.
date-timecurl -X PUT 'https://eu-sov-1.bytesafecloud.eu/v1/my-namespace-id/webhooks/string' \ -H 'Content-Type: application/json' \ -d '{ "description": "Blocked downloads go to the security channel.", "enabled": true, "eventTypes": [ "firewall.blocked" ], "firewalls": [], "name": "security alerts", "url": "https://hooks.example.com/firewall"}'{ "id": "whep-01K6Z3Q8R9T2V4X6Y8A0C2E4G6", "name": "security alerts", "url": "https://hooks.example.com/firewall", "enabled": true, "eventTypes": [ "firewall.blocked" ], "firewalls": [], "secret": "1F56ED4E-D401-49E4-B40C-0B7B8411BAD6", "createdAt": "2026-03-02T09:30:00Z", "updatedAt": "2026-03-02T09:30:00Z"}