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

# Update a webhook subscription

`PATCH /webhooks/{id}`

Updates a webhook subscription. Any combination of the subscribed event types, state (ACTIVE or DISABLED), and description may be changed, and at least one field must be supplied. Setting state to ACTIVE re-enables a subscription that was auto-blocked after sustained delivery failures.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `eventTypes` string[]
  - `state` 'ACTIVE' | 'DISABLED'
  - `description` string, nullable

## Response `200`

Updated webhook subscription

- object
  - `data` object, required
    - `id` string, uuid, required
    - `url` string, required
    - `eventTypes` string[], required
    - `state` 'ACTIVE' | 'DISABLED' | 'DELETED', required
    - `health` 'healthy' | 'failing' | 'blocked', required — System-observed delivery health. `blocked` endpoints are auto-disabled after sustained failure; PATCH state=ACTIVE to re-enable.
    - `blockedAt` string, nullable, required
    - `blockedReason` string, nullable, required
    - `signingEnabled` boolean, required
    - `description` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/mobilerun/apis/workflows.md) · [All operations](https://skmtc.net/mobilerun/apis/workflows/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobilerun/workflows/revisions/1bc499aa8f99/schema)