---
title: "Rotate the signing secret"
description: "Gives a webhook channel a new signing secret, shown only in this response. The old secret stops working at once."
canonical: https://docs.rumoro.dev/api/alerts/rotate-webhook-secret
markdown: https://docs.rumoro.dev/api/alerts/rotate-webhook-secret.mdx
---

# Rotate the signing secret

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

Gives a webhook channel a new signing secret, shown only in this response. The old secret stops working at once.

## Parameters

| Name | In | Description |
| --- | --- | --- |
| `id` | path, required | The channel's id (dest_...). |

## Responses

| Status | Meaning |
| --- | --- |
| 200 | The new signing secret, shown only now. The old one stops working right away. |
| 401 | The API key is missing or not valid |
| 404 | No webhook channel with this id |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).