---
title: "Update Webhook"
method: PATCH
path: "/agents/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Update Webhook

`PATCH /agents/webhooks/{webhook_id}`

Update a webhook's `url`, `secret`, or `display_name`. Omit `secret` to leave the existing secret unchanged.

## Path parameters

- `webhook_id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Request body

- UpdateWebhookBody — Fields to update on a webhook.
  - `url` string, uri, required — The HTTPS endpoint Cartesia POSTs call events to.
  - `secret` string — A new shared secret. Omit to leave the existing secret unchanged.
  - `display_name` string — An optional name to identify the webhook.

## Response `200`

Webhook updated. Returns the ID of the updated webhook.

- string — The ID of the updated webhook.

## Other responses

- `404` — Webhook not found.

---

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