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

# Update webhook

`PATCH /api/webhooks/{webhookId}`

Partially updates webhook configuration. Only provided fields will be updated. Use the separate status endpoint to activate/deactivate webhooks.

## Path parameters

- `webhookId` string, required

## Request body

- UpdateMuralWebhookInput
  - `categories` string[] — Event categories to subscribe to
  - `url` string — HTTPS URL endpoint where webhook events will be delivered

## Response `200`

Webhook 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)