Rotate a webhook’s signing secret
rotate_webhook_secretMint a new webhook signing secret when one leaks or changes hands; the old secret stays valid for 24 hours, letting receivers accept both signatures while you deploy.
Instructions
Mint a new signing secret for a subscription. THE ANSWER CARRIES IT ONCE, like create_webhook. The old secret goes on being honoured for 24 hours — every delivery in that window carries two signatures on the one webhook-signature header, new first, so a receiver that accepts either passes throughout — which is the window to get the new one deployed. Rotating again inside it replaces the previous secret rather than keeping three. Do this when a secret has leaked or when whoever held it has moved on.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"webhook_id": "<webhook_id>"
},
"name": "rotate_webhook_secret"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| webhook_id | Yes | The subscription id — `whk-` and sixteen hex characters. |