API referenceWebhooks
Rotate the signing secret
Scope webhooks:manage. Returns the new secret once. For 24 hours
(previous_secret_expires_at) every delivery carries two v1= entries in
X-FV-Signature, one per secret, so you can switch without a gap.
apiKeyheader
AuthorizationBearer <fv_live_… or fv_test_…>id*stringFormat
uuidThe webhook with its new secret
application/json- response
success*booleanrequest_id*stringFormat
uuiddata?curl -X POST 'https://api.flowverify.co/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08/rotate-secret'Example Response
{ "success": true, "request_id": "266ea41d-adf5-480b-af50-15b940c2b846", "data": { "object": "webhook", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "url": "string", "events": [ "string" ], "description": "string", "is_active": true, "api_version": "string", "last_delivery_at": "2019-08-24T14:15:22Z", "last_status": "string", "consecutive_failures": 0, "disabled_at": "2019-08-24T14:15:22Z", "disabled_reason": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "secret": "string", "previous_secret_expires_at": "2019-08-24T14:15:22Z" }}Send a test event POST
Scope `webhooks:manage`. Delivered synchronously; the response tells you whether your endpoint answered 2xx.
List delivery attempts for a webhook GET
Scope `webhooks:read`. Newest first; deliveries are retained for 30 days. Bodies are not returned — fetch the object through the API.