---
title: "Update a webhook"
method: PUT
path: "/webhooks/{webhook_id}"
tags: ["webhooks"]
---

# Update a webhook

`PUT /webhooks/{webhook_id}`

Update an existing webhook.

## Path parameters

- `webhook_id` string, required — The ID of the webhook to update.

## Request body

- UpdateWebhookRequest
  - `description` string — Human-readable purpose of the webhook.
  - `is_active` boolean — Whether the webhook is active.
  - `url` string — HTTPS URL that receives webhook deliveries; IP addresses are rejected.

## Response `200`

OK

- Webhook
  - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
  - `description` string, nullable, required — Webhook purpose.
  - `id` string, required — Unique resource identifier.
  - `is_active` boolean, required — Whether the webhook is active.
  - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
  - `url` string, required — Webhook destination URL.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/revisions/5b4c43e2941b/schema)