---
title: "Update Webhook"
method: PATCH
path: "/v1/webhooks/{id}"
tags: ["Webhooks"]
---

# Update Webhook

`PATCH /v1/webhooks/{id}`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/webhooks/{id}`
- Auth: API key in header `anchor-api-key`

Partial update — pass only the fields you want to change. Setting `enabled: false`
immediately stops events from fanning out to this webhook (existing in-flight
deliveries finish their attempts).

## Path parameters

- `id` string, required

## Request body

- WebhookUpdateRequest: Partial update — only the fields you include are changed.
  - `url` string, uri
  - `description` string, nullable
  - `subscribed_events` WebhookEventType[]
  - `enabled` boolean

## Response `200`

Webhook updated.

- WebhookPublic: A registered webhook subscription. The signing secret is NEVER returned by GET/list endpoints.
  - `id` string, required: Webhook id. Use as the path parameter on subsequent calls.
  - `project_id` string, uuid, required: The project (team) the webhook belongs to.
  - `url` string, uri, required: HTTPS URL Anchor will POST events to.
  - `description` string, nullable, required: Optional human-readable description.
  - `subscribed_events` WebhookEventType[], required: Event types this webhook is currently subscribed to.
  - `enabled` boolean, required: When `false`, no events fan out to this webhook.
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required

## Other responses

- `400`: Validation error (URL constraints same as create).
- `404`: Webhook not found in this project.
- `500`: Failed to update webhook.

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/webhooks/:id/patch.md)

---

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