Skip to content

Rotate a webhook signing secret

POST
/organizations/{org_id}/webhooks/{target_id}/rotate-secret
curl --request POST \
--url https://api.perstat.io/organizations/example/webhooks/example/rotate-secret \
--header 'Authorization: Bearer <token>'

Generates a new signing secret for the webhook target and returns it exactly once; signatures made with the previous secret are invalid immediately, there is no dual-secret grace window. Only valid for targets of kind webhook, Slack targets return 400. Requires project management rights.

org_id
required
string
target_id
required
string
Media typeapplication/json
object
secret
required

Neues volles Signatur-Secret, NUR in dieser Antwort.

string
Examplegenerated
{
"secret": "example"
}