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

# Update a webhook endpoint

`PATCH /v1/webhooks/{id}`

## Request

- Base URL: `https://api.signvoy.com`
- URL: `https://api.signvoy.com/v1/webhooks/{id}`
- Auth: one of:
  - API key in header `X-Workspace-Id`
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `id` string, required

## Request body

- UpdateWebhookDto
  - `url` string: New HTTPS URL for this endpoint
  - `description` string: Human-readable label
  - `enabledEvents` string[]: Events to subscribe to
  - `status` 'active' | 'disabled': Enable or disable this endpoint

## Response `200`

- WebhookEndpointDto
  - `id` string, uuid, required
  - `workspaceId` string, uuid, required
  - `url` string, uri, required: HTTPS URL Signvoy will POST events to
  - `description` object: Human-readable label
  - `enabledEvents` string[], required: Subscribed events. Empty array = all events.
  - `status` 'enabled' | 'disabled', required
  - `consecutiveFailures` integer, required: Count of consecutive delivery failures
  - `disabledAt` string, date-time, nullable
  - `successRate` integer, nullable: Percentage of successful deliveries (null if no deliveries yet)
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

---

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