ReferenceWebhooks
Rotate a webhook endpoint's secret
Makes a new secret.
POST
secretKeyheader
AuthorizationBearer <sk_live_… or sk_test_… (a prefix and 40 base62 characters)>A secret key from the dashboard, sent as Authorization: Bearer sk_live_…. Live keys run real, charged calls; test keys (sk_test_…) run calls of at most 60 seconds, 20 a day per organization, never charged. Each key sees only its own env's calls, meetings, webhooks, memories and analytics. Publishable keys (pk_…) are refused.
webhook_id*stringThe webhook endpoint's id.
Match
^whe_[0-9A-Za-z]{20}$Example
"whe_6Tn1Vb8XcK3mPq9LsD2f"application/json- body
Example
{ "grace_seconds": 3600}grace_seconds?integerHow long the old secret also signs. 0 stops it at once.
Range
0 <= value <= 604800Default
86400The endpoint and its new secret.
application/json- response
webhook*An endpoint (never its secret).
Example
{ "id": "whe_6Tn1Vb8XcK3mPq9LsD2f", "url": "https://example.com/hooks/calls", "description": "our CRM", "event_types": [], "env": "live", "enabled": true, "disabled_reason": null, "failing_since_unix": null, "previous_secret_until_unix": null, "created_unix": 1793300000, "updated_unix": 1793300000}secret*WebhookSecretA signing secret: whsec_ and 32 random bytes in base64. Shown only when it is made.
Match
^whsec_[A-Za-z0-9+/]{43}=$Example
"whsec_BwgJCgsMDQ4PEBESExQVFhcYGRobHB0eHyAhIiMkJSY="curl -X POST 'https://api.daxov.com/v1/webhooks/whe_6Tn1Vb8XcK3mPq9LsD2f/rotate' \ -H 'Content-Type: application/json' \ -d '{ "grace_seconds": 3600}'Example Response
{ "webhook": { "id": "whe_6Tn1Vb8XcK3mPq9LsD2f", "url": "https://example.com/hooks/calls", "description": "our CRM", "event_types": [], "env": "live", "enabled": true, "disabled_reason": null, "failing_since_unix": null, "previous_secret_until_unix": null, "created_unix": 1793300000, "updated_unix": 1793300000 }, "secret": "whsec_BwgJCgsMDQ4PEBESExQVFhcYGRobHB0eHyAhIiMkJSY="}