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

# Update Webhook

`PATCH /v1/webhooks/{webhookId}`

Update a webhook configuration. Requires API key with webhook:write.

## Path parameters

- `webhookId` string, required

## Request body

- UpdateWebhookRequest
  - `url` string, uri — The webhook endpoint URL (must be HTTPS)
  - `events` string[] — Array of event types to subscribe to
  - `active` boolean — Whether the webhook is active
  - `description` string — Optional description for the webhook
  - `customHeaders` object — Optional custom headers to include in webhook requests

## Response `200`

Webhook updated

- ApiResponseSuccess
  - `success` boolean, required
  - `data` object, nullable
    - `success` boolean
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/3f3dba69574b/schema)