Skip to main content
POST
/
webhooks
/
{id}
/
rotate-secret
cURL
curl --request POST \
  --url https://api.useanima.sh/v1/webhooks/{id}/rotate-secret \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "id": "<string>",
  "secret": "<string>"
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Path Parameters

​
id
string
required

Unique identifier of the webhook whose secret to rotate

Pattern: ^[0-9a-z]+$

Body

application/json

Request body for rotating a webhook signing secret

Response

200 - application/json

OK

Result of rotating a webhook signing secret

​
id
string
required

Unique identifier of the webhook

Pattern: ^[0-9a-z]+$
​
secret
string
required

The new signing secret, returned only once. Update your receiver to verify with this value; the previous secret stops working immediately.