---
title: "Update webhook endpoint"
method: PATCH
path: "/v2/organizations/{organizationId}/webhooks/{endpointId}"
tags: ["Webhooks"]
---

# Update webhook endpoint

`PATCH /v2/organizations/{organizationId}/webhooks/{endpointId}`

## Request

- Base URL: `https://api.pdfs.build`
- URL: `https://api.pdfs.build/v2/organizations/{organizationId}/webhooks/{endpointId}`
- Auth: HTTP bearer

Change the URL, description or enabled state. Disabling an endpoint stops future deliveries; deliveries already queued are dropped. Not plan-gated.

## Request body

- UpdateWebhookRequest
  - `url` string, uri
  - `description` string, nullable: `null` clears the description; omit to leave it unchanged.
  - `enabled` boolean

## Response `200`

The updated endpoint.

- WebhookEndpoint
  - `id` string, required
  - `organizationId` string, required
  - `url` string, uri, required
  - `enabled` boolean, required
  - `description` string, nullable, required
  - `createdAt` string, required: UTC, ISO 8601 without a timezone suffix.
  - `updatedAt` string, required: UTC, ISO 8601 without a timezone suffix.

## Other responses

- `400`: `invalid_url` (not a well-formed http(s) URL) or `url_not_allowed` (resolves to a non-public address).
- `401`: Missing, invalid or expired API key.
- `403`: The organization in the URL does not match the API key's organization.
- `404`: `not_found` — no such endpoint in this organization.

---

[API](https://skmtc.dev/pdfs/apis/pdfs-build-api.md) · [All operations](https://skmtc.dev/pdfs/apis/pdfs-build-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pdfs/apis/pdfs-build-api/revisions/1c7340b9521d?raw)