---
title: "Rotate Webhook Subscription Secret"
method: POST
path: "/api/webhooks/subscriptions/{subscription_id}/rotate-secret"
tags: ["webhooks"]
---

# Rotate Webhook Subscription Secret

`POST /api/webhooks/subscriptions/{subscription_id}/rotate-secret`

## Request

- Base URL: `https://zsign.io` (the document declares no server; this is the origin it was published from)
- URL: `https://zsign.io/api/webhooks/subscriptions/{subscription_id}/rotate-secret`
- Auth: HTTP bearer

Generate a new signing secret for one managed subscription.

## Path parameters

- `subscription_id` string, uuid, required

## Response `200`

Successful Response

- SecretRotateResponse
  - `secret` string, required

## Other responses

- `422`: Validation Error

---

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