/v1/workspaces/{workspace_id}/webhooks/{id}/rotate-secretAuthRotate the signing secret. Returns the new secret in clear EXACTLY ONCE; the old one stops at once.
Deprecated: use `/v1/workspaces/{workspace_id}/webhooks/endpoints` (event filter, event descriptions, Send test that reports the result, event log, replay, rotation with a grace period). Responses carry `Deprecation: true` and `Sunset: Fri, 15 Jan 2027 00:00:00 GMT`.
Path parameters
workspace_id*string · uuidId of the workspace.
id*string · uuidId of the webhook.
Response · 201 Secret rotated. Includes the new plaintext secret exactly once.
id*string · uuidsecret*stringNew plaintext signing secret, returned EXACTLY ONCE. Persist immediately; the old secret stops working at once.
Example
Request
POST https://api.trawl.productcraft.co/v1/workspaces/{workspace_id}/webhooks/{id}/rotate-secret
Authorization: Bearer YOUR_TOKENResponse
{
"id": "00000000-0000-0000-0000-000000000000",
"secret": "string"
}