---
title: "Update a webhook endpoint"
method: PATCH
path: "/api/v1/webhooks/{id}"
---

# Update a webhook endpoint

`PATCH /api/v1/webhooks/{id}`

## Request

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

Change its events, or disable and re-enable it. Re-enabling clears the recorded delivery error.

## Path parameters

- `id` string, required

## Request body

- object
  - `events` string[]
  - `disabled` boolean
  - `payload` object: Opt in to carrying the transcript in the delivery, for a receiver that cannot call the API back. Omitted above 256 KB, with text_omitted saying why.
    - `text` boolean
    - `format` 'txt' | 'srt' | 'vtt' | 'json'

## Response `200`

Updated

- object

## Other responses

- `401`: Missing or invalid API key
- `404`: No such resource on this account

---

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