Sign in
latestOpenAPI 3.1.0Proprietary - Prezent, Inc.2026-08-114675175.5 KB

a01cb764a085

Webhooks

Update a webhook subscription

Partial update. Any combination of url, events, description, or status may be supplied. Changes to url are re-validated against the SSRF / scheme / port rules. Setting status to "active" re-enables an auto-disabled subscription.

patch/api/v1/webhook-subscriptions/{id}

Path parameters

idstring required
Example:whsub_3f7a9b1c8d2e4f5a6b7c8d9e0f1a2b3c

The public subscription id returned by POST /api/v1/webhook-subscriptions — shaped whsub_<32 hex chars>.

Request body

urlstring uri
eventsWebhookEventType[]
descriptionstring nullable
status'active' | 'disabled'

active subscriptions receive deliveries. disabled subscriptions are skipped at dispatch time — either explicitly set by the customer or set by Prezent's auto-disable rule after 50 consecutive delivery failures. PATCH status: active to re-enable.

Response

Subscription updated.

successboolean

true on success (omitted by some legacy handlers).

Example response

{
  "data": {
    "id": "whsub_3f7a9b1c8d2e4f5a6b7c8d9e0f1a2b3c",
    "url": "https://hooks.example.com/prezent",
    "secret_prefix": "whsec_",
    "events": [
      "autogeneration.completed",
      "autogeneration.failed"
    ],
    "description": "Push completions into our deal-room worker."
  }
}