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

# Update webhook

`PATCH /webhooks/{webhook_id}`

Updates an existing webhook. Only include the fields you want to change — omitted fields remain unchanged. Fields cannot be set to `null`.

## Path parameters

- `webhook_id` string, required

## Request body

- WebhookUpdate
  - `url` string, nullable — New HTTPS URL. Max 2048 characters.
  - `events` WebhookEvent[], nullable — New list of subscribed events. Replaces the existing list. At least one event is required.
  - `enabled` boolean, nullable — Enable or disable the webhook.

## Response `200`

The updated webhook.

- WebhookResponse
  - `id` string, required — Webhook ID.
  - `url` string, required — The registered URL.
  - `events` WebhookEvent[], required — Subscribed events.
  - `enabled` boolean, required — Whether the webhook is active.
  - `created_at` string, date-time, required — ISO 8601 timestamp.
  - `updated_at` string, date-time, required — ISO 8601 timestamp.

## Other responses

- `400` — Invalid request parameters.
- `401` — Authentication required.
- `404` — Webhook not found.
- `422` — Validation Error

---

[API](https://skmtc.net/timeless/apis/timeless-public-api.md) · [All operations](https://skmtc.net/timeless/apis/timeless-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timeless/timeless-public-api/revisions/e591036e462c/schema)