---
title: "Rotate a webhook secret"
canonical: https://docs.mentio.dev/api/alerts/rotate-webhook-secret
markdown: https://docs.mentio.dev/api/alerts/rotate-webhook-secret.mdx
---

# Rotate a webhook secret

`POST /v1/channels/{id}/rotate-secret`

## Parameters

- `id` (path, required): Channel id (dest_...).

## Responses

- 200: A new signing secret, shown once. The previous one stops verifying immediately.
- 401: Missing or invalid API key
- 404: Webhook channel not found

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx