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

# Update a webhook subscription

`PATCH /webhooks/{webhook_id}`

Update a subscription's URL, subscribed events, label, or active state.
    Only the provided fields are changed. The secret cannot be changed or
    retrieved — delete and recreate to rotate it.

    Authentication:
    - API key with READ_WRITE permission

## Path parameters

- `webhook_id` string, uuid, required

## Request body

- object — Request body to update an existing webhook subscription. All fields are optional; only the provided fields are changed.
  - `webhook_url` string, nullable — New destination URL.
  - `events` string[], nullable — Replacement set of subscribed event types.
  - `description` string, nullable — New human-readable label.
  - `is_active` boolean, nullable — Enable or disable deliveries to this subscription.

## Response `200`

Subscription updated

- unknown

## Other responses

- `400` — Invalid request data
- `401` — Invalid or missing API key
- `403` — Insufficient permissions
- `404` — Resource not found

---

[API](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1.md) · [All operations](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yourang/yourang-ai-external-api-v1/versions/49680ee64400/schema)