Rotate the signing secret
POST
/webhooks/{id}/rotate-secret
Issues a new secret and shows it once. The new secret takes effect for subsequent deliveries immediately, nothing else is needed. Each endpoint has its own secret: rotating the primary's does not affect the backup's.
Authorizations
ApiKeyAuth
API key from the dashboard. Some Host Mode endpoints also accept the key as an api_key field in the request body — this is stated in the schema of the particular operation.
Type
API Key (header: X-API-KEY)
Parameters
Header Parameters
X-Real-IP*
An IP address from the key's whitelist. A request from an address outside the whitelist is rejected with 401.
Type
Requiredstring
Example
"203.0.113.10"Format
"ipv4"Path Parameters
id*
Type
Requiredinteger
Responses
The new secret — shown only this once.
application/json
JSON "detail": { "code": 10000, "status": "rotated", "data": { "id": 0, "secret": "string" } }
{
}