---
title: "Update the specified Webhook"
method: PATCH
path: "/v1/webhooks/{uuid}"
tags: ["webhooks"]
---

# Update the specified Webhook

`PATCH /v1/webhooks/{uuid}`

## Path parameters

- `uuid` string, uuid, required

## Request body

- WebhookUpdate
  - `description` string
  - `scopes` WebhookResource[], nullable — One or more resources to fire webhooks for. Available resources include comments, companies, engagements, milestones, requests, users. If `null`, webhooks will fire for all resources.

## Response `200`

The updated Webhook

- object
  - `data` WebhookRead, required
    - `uuid` string, uuid, required — The unique ID for the webhook, referenced as `webhook_uuid` in webhook requests
    - `description` string, required — A human-readable description of the webhook's use
    - `scopes` WebhookResource[], nullable, required — One or more resources to fire webhooks for. Available resources include comments, companies, engagements, milestones, requests, users. If `null`, webhooks will fire for all resources.
    - `url` string, uri, required
    - `created_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden (requires scopes `webhooks:write`)
- `404` — Resource not found
- `429` — Too many requests

---

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