Rotate an endpoint's signing secret
Returns a new `secret` once. For the next 24 hours deliveries carry signatures from both the new and the old secret in `webhook-signature`, so you can switch without dropping events.
Returns a new secret once. For the next 24 hours deliveries carry signatures from both the new and the old secret in webhook-signature, so you can switch without dropping events.
X-API-Key<token>Create in the console: Settings → API & webhooks.
endpoint_id*Endpoint IdWebhook endpoint id.
OK
application/json- response
secret*SecretSigning secret (whsec_...). Shown only in this response; store it securely.
success?SuccessAlways true on a 2xx response.
truewebhookEndpoint*[key: string]?anycurl -X POST 'https://api.callmitra.ai/api/v1/webhook-endpoints/string/rotate-secret'{ "secret": "whsec_C2FVsBQIhrscChlQIMV+b5sSYspob7oD", "success": true, "webhookEndpoint": { "consecutiveFailures": 0, "createdAt": "2026-11-01T08:15:00+00:00", "description": "CRM sync", "enabled": true, "events": [ "call.completed", "call.escalated", "lead.created" ], "id": "4f0c2a8e-7b1d-4c39-9a51-2d6e8f3b1c07", "lastStatus": "HTTP 200", "lastSuccessAt": "2026-11-15T10:42:07.512000+00:00", "previousSecretExpiresAt": "2026-11-16T10:50:00+00:00", "updatedAt": "2026-11-15T10:42:07.512000+00:00", "url": "https://example.com/hooks/call-mitra" }}Redeliver an event POST
Queues the same event (same `id` and `webhook-id`) to the same endpoint again, due now. Returns the new delivery. Tests and redeliveries share a cap of 10 per endpoint per minute (429 with `Retry-After`).
Send a test event POST
Sends a signed `webhook.test` event to the endpoint now, whatever its event filter, and returns the delivery with the endpoint's answer. A failed test is retried like any other delivery. Tests and redeliveries share a cap of 10 per endpoint per minute (429 with `Retry-After`).