---
title: "Update webhook status"
method: PATCH
path: "/api/webhooks/{webhookId}/status"
tags: ["Webhooks"]
---

# Update webhook status

`PATCH /api/webhooks/{webhookId}/status`

Updates the status of a webhook (ACTIVE/DISABLED). This operation is idempotent - if the status is already the requested value, no changes are made.

## Path parameters

- `webhookId` string, required

## Request body

- UpdateWebhookStatusInput
  - `status` 'DISABLED' | 'ACTIVE', required — Webhook status - use to activate/deactivate

## Response `200`

Webhook status updated successfully

- MuralWebhook
  - `categories` string[], required — Event categories this webhook is subscribed to
  - `createdAt` string, date-time, required — When the webhook was created
  - `id` string, required — Unique webhook identifier
  - `publicKey` string, required — ECDSA public key in PEM format for signature verification
  - `status` 'DISABLED' | 'ACTIVE', required — Webhook status
  - `updatedAt` string, date-time, required — When the webhook was last updated
  - `url` string, required — Webhook endpoint URL
  - `version` number, required — Webhook version for tracking changes

## Other responses

- `401` — Unauthorized
- `403` — SignedAgreementRequiredException

---

[API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/versions/437d277f5948/schema)