---
search:
  tags:
    - Operations
    - PATCH
seo:
  description: >-
    Session-gated; requires app:write on the webhook's app. Re-enable is…
    Reference for the PATCH /api/v1/webhooks/{webhookId} endpoint in the
    Charming API.
sidebar:
  label: Rename a Webhook, change its enabled state, or rotate its secret
  badge: PATCH
title: Rename a Webhook, change its enabled state, or rotate its secret
type: openapi-operation
---
Session-gated; requires `app:write` on the webhook's app. Re-enable is `{enabled: true}` — not a separate action — and resets the consecutive-failure counter. `{rotate_secret: true}` replaces the secret immediately and returns the new one once. `name` relabels the Webhook.

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

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.