> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teel.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Rotate signing secret

> Mint a new signing secret and invalidate the previous one

Mints a new `whsec_…` secret and returns it once. **The previous secret is invalidated immediately — there is no overlap window.**

If you need overlap (e.g. rolling deploys), use this flow:

1. [Pause](/api-reference/webhooks/subscriptions/update) the subscription.
2. Rotate the secret here.
3. Deploy your verifier with the new secret.
4. Unpause the subscription via Update.

<Info>**Scope** `webhooks:write` · rate-limited</Info>

## Headers

<ParamField header="Authorization" type="string" required>
  API key.
</ParamField>

## Path parameters

<ParamField path="id" type="string" required>
  Subscription UUID.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Subscription UUID.
</ResponseField>

<ResponseField name="secret" type="string">
  The new signing secret in plaintext. Returned only here — store it immediately.
</ResponseField>

<ResponseField name="secretPrefix" type="string">
  First few characters of the new secret.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "1c84203c-b4e3-40de-83a9-51bc0d9c991f",
    "secret": "whsec_Qx9_NK7gh-ZbR43210uVdMcEw2pf3CYn5pAUmeU1XYW8",
    "secretPrefix": "whsec_Qx9_NK"
  }
  ```
</ResponseExample>