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

# Regenerate Secret

> Generate a new signing secret for a webhook endpoint.

## Path Parameters

**webhookId** `string` *required*

The unique identifier of the webhook endpoint.

## Response

**success** `boolean`

Indicates if a new secret was generated.

**webhookId** `string`

The endpoint the secret belongs to.

**secret** `string`

The new signing secret (64 hexadecimal characters). **Store this securely. It is only returned once.**

```json 200 Success theme={null}
{
  "success": true,
  "webhookId": "wh_abc123def456",
  "secret": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
}
```

```json 404 Not Found theme={null}
{
  "error": "Webhook endpoint not found"
}
```

## Behavior

* The old secret stops working immediately. Update the receiving system with the new secret straight away, or its signature checks fail until you do.
* Deliveries that are being retried are signed with the new secret.
* In the dashboard the same action is the **Regenerate Secret** button on the Review step of an existing webhook under **Connecter > Webhooks**.

> [!NOTE]
>
> This endpoint requires **JWT authentication** (the login token of a dashboard user), not an `okt_` API token.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.