Rotate an endpoint signing secret
Requires current webhooks:manage authority. Returns only the new signing secret and the original previous-key expiry. Identical application-scoped Idempotency-Key retries recover that same new-key receipt during its 24-hour window; using that key for another owned endpoint conflicts instead of rotating it. Expired command keys cannot be reused. Signs with both current and previous keys for the explicit 24-hour overlap, then never opens or uses the previous key. Another rotation returns HTTP 409 (webhook_rotation_in_progress) while the overlap is active so it cannot shorten that promise. Verification and endpoint status remain unchanged. Retirement clears current/previous and receipt ciphertext while retaining command identities so a retry cannot rotate another endpoint. Later endpoint reads never return secrets.
Path Parameters
- Type: stringendpoint
Id required
Headers
- Type: stringIdempotency
- Key min length:1max length:255required
Responses
- application/json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
- application/problem+json
curl 'https://api.dev.eno.health/v1/webhook-endpoints/{endpointId}/secret-rotations' \
--request POST \
--header 'Idempotency-Key: ' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"endpointId": "string",
"signingSecret": "string",
"previousSecretExpiresAt": "2026-11-16T18:04:16.398Z"
}