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

# Update a webhook endpoint

`PATCH /v1/webhooks/{uuid}`

Update a webhook endpoint's `label`, `url`, `subscribed_events`, or `enabled` flag. Send `rotate_secret: true` to generate a new signing secret — the new secret is returned in full in that response only. Send only the fields you want to change.

## Path parameters

- `uuid` string, uuid, required

## Request body

- object
  - `label` string — You optionally set the endpoint label.
  - `url` string, uri — You optionally set the destination URL.
  - `subscribed_events` string[] — You optionally replace the subscribed event types.
  - `enabled` boolean — You optionally enable or disable the endpoint.
  - `rotate_secret` boolean — You optionally rotate the signing secret. When `true`, the response returns the new secret in full.

## Response `200`

The webhook endpoint was updated. The `secret` is returned in full only when `rotate_secret` was `true`, otherwise it is masked.

- object
  - `id` string, uuid — You receive the UUID for this webhook endpoint.
  - `label` string — You receive the endpoint label.
  - `url` string, uri — You receive the destination URL that receives POST deliveries.
  - `secret` string — You receive the masked signing secret (only the last 4 characters are shown).
  - `subscribed_events` string[] — You receive the event types this endpoint is subscribed to. An empty array means all event types are delivered.
  - `enabled` boolean — You receive `true` when the endpoint is active and receiving deliveries.
  - `created_at` string, date-time — You receive the timestamp when the endpoint was created.
  - `updated_at` string, date-time — You receive the timestamp when the endpoint was last updated.

---

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