v28

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-07-082940159.9 KB

Webhooks

Update a webhook

Updates specific fields of a webhook endpoint

patch/v1/webhooks/{id}

idstring uuid required

Example:018e1234-5678-9abc-def0-123456789abc

Webhook ID (UUID)

urlstring uri

New webhook URL. Must be an HTTP or HTTPS URL. NULL bytes not allowed.

signing_keystring

New signing key. NULL bytes not allowed.

enabledboolean

Enable or disable the webhook

tenant_idstring

Omit to leave unchanged. Empty strings are rejected; webhooks cannot be global.

event_typesWebhookEventType[]

New list of event types (use empty array to clear). Each value must be one of WebhookEventType.

{
  "url": "https://example.com/hub-events",
  "signing_key": "whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "tenant_id": "org-123"
}

OK. Returns WebhookPublicData (signing_key omitted).

idstring uuid required

Webhook ID (UUID)

urlstring required

URL that receives webhook POSTs

enabledboolean required

Whether the webhook is active

tenant_idstring

Tenant/organization identifier

event_typesWebhookEventType[]

Event types this webhook subscribes to (empty = all)

created_atstring date-time required

When the webhook was created

updated_atstring date-time required

When the webhook was last updated

disabled_reasonstring nullable

Read-only. Set by the system when the webhook was disabled. Omitted when null.

disabled_atstring date-time nullable

Read-only. When the webhook was disabled. Omitted when null.