---
title: "PATCH /v1/webhooks/{uid}"
method: PATCH
path: "/v1/webhooks/{uid}"
tags: ["webhooks"]
---

# PATCH /v1/webhooks/{uid}

`PATCH /v1/webhooks/{uid}`

Update a webhook subscription

## Path parameters

- `uid` string, required

## Request body

- object
  - `url` string, uri
  - `event` 'sdk.build.completed'
  - `description` string
  - `enabled` boolean

## Response `200`

Default Response

- object
  - `uid` string, required
  - `createdAt` integer, required
  - `updatedAt` integer, required
  - `event` 'sdk.build.completed', required
  - `url` string, uri, required
  - `enabled` boolean, required
  - `description` string, required
  - `consecutiveFailures` integer, required
  - `disabledReason` 'consecutive-failures'
  - `disabledAt` number, nullable

## Other responses

- `400` — Bad request
- `401` — No auth
- `403` — Forbidden
- `404` — Not found
- `422` — Invalid payload
- `500` — Uncaught error

## Changes

- **2026-08-24** `002d44a0c0e6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/scalar/apis/core/changes/v1/webhooks/:uid/patch.md)

---

[API](https://skmtc.dev/scalar/apis/core.md) · [All operations](https://skmtc.dev/scalar/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scalar/core/revisions/2c53f2191a3e/schema)