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

# Update a webhook

`PATCH /v1/webhooks/{id}`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/webhooks/{id}`
- Auth: API key in header `x-api-key`

Update an endpoint's `url`, `event_types`, and/or `enabled`. Re-enabling a disabled endpoint clears its failure streak. Send at least one field.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- Webhook: A registered webhook endpoint.
  - `id` string, required: Webhook ID (UUID).
  - `url` string, required: Your HTTPS endpoint, where events are POSTed.
  - `description` string, nullable, required: Your label for the endpoint. `null` when you did not set one.
  - `event_types` string[], required: Which events this endpoint receives.
  - `enabled` boolean, required: `false` once you disable it, or after sustained delivery failures auto-disable it.
  - `secret` string: The signing secret for `Sonovault-Signature`. Returned **only** by `POST /v1/webhooks`, once. Store it then; it is never shown again.
  - `created_at` string, required: When the endpoint was registered, ISO-8601 UTC.
  - `last_delivery_at` string, nullable, required: Last delivery attempt, ISO-8601 UTC. `null` before the first one.

---

[API](https://skmtc.dev/sonovault/apis/sonovault-api.md) · [All operations](https://skmtc.dev/sonovault/apis/sonovault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonovault/apis/sonovault-api/revisions/0152fff23f2c?raw)