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

# Update a webhook

`PATCH /webhooks/{webhookId}`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/webhooks/{webhookId}`
- Auth: HTTP bearer

Change where it sends, what it sends or whether it is on. Turning a paused webhook back on
clears the pause. Whoever edits a webhook becomes its creator, so its events follow their access.

## Request body

- object
  - `url` string, uri
  - `events` string[]
  - `boardId` string, nullable
  - `description` string
  - `active` boolean

## Response `200`

OK

- Webhook
  - `id` string
  - `url` string, uri
  - `events` string[]
  - `boardId` string, nullable: Null for every board in the workspace.
  - `description` string
  - `active` boolean
  - `pausedReason` string, nullable: Why MockFlow paused it
  - `createdBy` string, nullable: Events are sent only about boards this person can open.
  - `createdAt` string, date-time
  - `updatedAt` string, date-time, nullable

## Other responses

- `429`: Too many requests.
- `4XX`: An error. See the envelope and the code list on the Errors page.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)