---
title: "Update a webhook subscription"
method: PATCH
path: "/webhooks/{id}/"
tags: ["Webhooks"]
---

# Update a webhook subscription

`PATCH /webhooks/{id}/`

## Request

- Base URL: `https://api.parsewise.ai/api/v1`
- URL: `https://api.parsewise.ai/api/v1/webhooks/{id}/`
- Auth: API key in header `X-API-Key`

Manage outbound webhook subscriptions for the authenticated tenant.

Subscriptions are tenant-scoped. Only active subscriptions are returned
by ``list`` and ``retrieve``. Deletion is permanent — the row is removed
from the DB and any associated delivery rows cascade.

## Path parameters

- `id` string, uuid, required

## Request body

- PatchedV1WebhookSubscriptionWriteRequest: Validates create / update bodies. Not bound to the model.
  - `name` string: Friendly name for this subscription (optional).
  - `url` string: HTTPS URL Parsewise will POST webhook events to.
  - `subscribed_events` string[]: Event names this subscription should receive.
  - `headers` object: Custom HTTP headers to include with every delivery. Encrypted at rest. Up to 10 entries; values up to 1KB each; total ≤ 4KB. The Host, Connection, Content-Length, Transfer-Encoding, Content-Type and any Parsewise-* headers are reserved.

## Response `200`

- V1WebhookSubscription: Read-side serializer. Used by list / retrieve / create / update responses.
  - `id` string, uuid, required
  - `name` string, required
  - `url` string, required
  - `subscribed_events` string[], required: Event names this subscription is subscribed to.
  - `is_active` boolean, required
  - `headers` object, required: Custom request header keys registered for this subscription. Values are always redacted.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/parsewise/apis/parsewise-api.md) - [All operations](https://skmtc.dev/parsewise/apis/parsewise-api/llms.txt) - [OpenAPI document](https://skmtc.dev/parsewise/apis/parsewise-api/revisions/5db46512debf?raw)