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

# Update webhook

`PATCH /webhooks/{id}`

Update an existing webhook for the current workspace. All fields are optional—only include the fields you want to update.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string — The name of the webhook
  - `url` string, uri — The URL that will receive webhook events
  - `description` string — An optional description for the webhook
  - `topics` string[] — The event types this webhook should listen to
  - `headers` object — Optional custom headers to include in webhook requests

## Response `200`

Webhook updated

- Webhook — A webhook configuration for receiving event notifications
  - `id` string, uuid
  - `name` string
  - `url` string, uri
  - `description` string, nullable
  - `headers` object, nullable
  - `topics` string[]
  - `createdAt` string, date-time
  - `createdBy` WebhookCreatedBy — User who created the webhook
    - `id` string, uuid
    - `email` string, email
    - `firstName` string, nullable
    - `lastName` string, nullable

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Missing or invalid API key
- `404` — Not Found - Resource does not exist

---

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