Skip to Content
FlowVerifyDevelopers

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.

Authorization

apiKey
headerAuthorizationBearer <fv_live_… or fv_test_…>

Path Parameters

id*string
Formatuuid

Response Body

The webhook with its new secret

application/json
  1. response
success*boolean
request_id*string
Formatuuid
data?
Example Request
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"  }}