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

# Edit a webhook

`PATCH /webhooks/{id}`

Update a single webhook

## Request body

- object
  - `data` object, required
    - `attributes` object, required
      - `url` string, uri — The URL of the webhook endpoint.
      - `events` string[] — The list of events to enable for this endpoint.
      - `active` boolean
      - `headers` object[] — Optional custom headers to pass with each webhook invocation
        - `name` string — The name of the header. (Please not this will be auto-capitalized)
        - `value` string — The value to pass for the header
    - `type` 'webhook', required

## Response `200`

OK

- object
  - `data` Webhook
    - `id` string, uuid, required
    - `type` 'webhook', required
    - `attributes` object
      - `url` string, uri, required — https end point
      - `active` boolean, required — Whether the webhook will be delivered when events are triggered
      - `events` string[], required — The list of events to enabled for this endpoint
      - `secret` string, required — A random token that will sign all delivered webhooks
      - `headers` object[], nullable
        - `name` string
        - `value` string

## Changes

> 54 revisions in range; 6 could not be searched.

- **2026-05-22** `08fd26cf8515` — 7 warning, 7 info
  - added the new `container.pickup_appointment.changed` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.pickup_lfd_rail.changed` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.pickup_lfd_terminal.changed` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `container.transport.delivered` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - …10 more
- **2026-03-26** `90a04ac576b7` — 2 warning, 2 info
  - added the new `document.extracted` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `document.extraction_failed` enum value to the `data/attributes/events/items/` response property for the response status `200`
  - added the new `document.extracted` enum value to the request property `data/attributes/events/items/`
  - added the new `document.extraction_failed` enum value to the request property `data/attributes/events/items/`
- …earlier changes not shown

[Full history](https://skmtc.dev/terminal49/apis/terminal49-api-reference/changes/webhooks/:id/patch.md)

---

[API](https://skmtc.dev/terminal49/apis/terminal49-api-reference.md) · [All operations](https://skmtc.dev/terminal49/apis/terminal49-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/terminal49/terminal49-api-reference/revisions/998a27e39c03/schema)