Skip to main content
POST
/
v1
/
webhooks
/
endpoints
/
{id}
/
rotate
Rotate webhook secret
curl --request POST \
  --url https://api.truthlocks.com/v1/webhooks/endpoints/{id}/rotate \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "secret": "<string>",
  "rotated_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt

Use this file to discover all available pages before exploring further.

Generates a new signing secret for a webhook endpoint. The old secret stops working immediately. The new secret is returned once — store it securely.
Rotating the secret invalidates the previous secret immediately. Update your webhook verification code with the new secret before processing further events.

​
Parameters

​
id
uuid
required
The ID of the webhook endpoint

​
Responses

After rotating, update your webhook verification code with the new secret immediately. Any deliveries signed with the old secret will fail verification.

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
id
string
required

Webhook endpoint ID

Response

Secret rotated

​
id
string
​
secret
string
​
rotated_at
string