---
title: "PUT /v1/projects/{projectOrProductUID}/webhooks/{webhookUID}"
method: PUT
path: "/v1/projects/{projectOrProductUID}/webhooks/{webhookUID}"
tags: ["webhook"]
---

# PUT /v1/projects/{projectOrProductUID}/webhooks/{webhookUID}

`PUT /v1/projects/{projectOrProductUID}/webhooks/{webhookUID}`

Updates the configuration settings for the specified webhook. | Webhook will be created if it does not exist. Update body will completely replace the existing settings.

## Path parameters

- `projectOrProductUID` string, required
- `webhookUID` string, required

## Request body

- WebhookSettings
  - `disabled` boolean — Flag indicating if the webhook is disabled
  - `id` string — Webhook ID
  - `transform` string — Transformation to be applied to the event

## Response `200`

Webhook updated successfully

## Other responses

- `default` — The response body in case of an API error.

## Changes

- **2026-07-10** `1887e880199a` — 1 breaking, 6 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `default`
  - added the optional property `debug` to the response with the `default` status
  - added the optional property `details` to the response with the `default` status
  - added the optional property `request` to the response with the `default` status
  - …3 more

[Change history](https://skmtc.dev/notefile/apis/notehub-api/changes/v1/projects/:projectOrProductUID/webhooks/:webhookUID/put.md)

---

[API](https://skmtc.dev/notefile/apis/notehub-api.md) · [All operations](https://skmtc.dev/notefile/apis/notehub-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/notefile/notehub-api/revisions/9c5b2b63a991/schema)