VocalDocscontracts 1.65.0

WebhookSecretRotation

The answer of a rotation (1.63.0): the new secret once, and how long the previous one keeps signing. A rotation inside the window retires the oldest secret.

An object with 5 fields.

Fields

FieldTypeRequiredDescription
object"webhook_secret_rotation"yes
previous_secret_expires_atTimestamp or nullyesUntil when each delivery also carries a v1 signature under the previous secret, the new one first; null when it was retired at once.
secretWebhookSecretyesThe new secret, shown in this answer only.
secret_hintstringyes
webhook_idWebhookIdyes

Used by

The operations whose parameters, request body or responses name this shape directly.