---
title: "Update a webhook"
method: PATCH
path: "/webhooks/{uid}"
---

# Update a webhook

`PATCH /webhooks/{uid}`

## Path parameters

- `uid` string, required

## Request body

- object
  - `name` string, required — Webhook name
  - `url` string, uri, required — URL to receive webhook events
  - `resource` 'image' | 'batch' | 'tool_job' | 'workflow_run' | 'animation' — Resource type to trigger on
  - `event` 'all_events' | 'completed' | 'failed' — Event type to trigger on
  - `status` 'active' | 'disabled' — Webhook status

## Response `200`

Updated webhook

- object
  - `uid` string
  - `name` string
  - `url` string, uri
  - `resource` 'image' | 'batch' | 'tool_job' | 'workflow_run' | 'animation'
  - `event` 'all_events' | 'completed' | 'failed'
  - `status` 'active' | 'disabled'
  - `created_at` string, date-time

## Other responses

- `404` — Webhook not found in this workspace
- `422` — Validation failure

---

[API](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api.md) · [All operations](https://skmtc.dev/bannerbear/apis/bannerbear-v5-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bannerbear/bannerbear-v5-api/revisions/6aa425420a10/schema)