Passer au contenu principal
POST
Crée un nouveau secret de signature pour un webhook. L’ancien secret continue de signer pendant 24 heures, jusqu’à previous_secret_expires_at. Une deuxième rotation dans ce délai révoque immédiatement le secret le plus ancien.
Nécessite le scope webhooks_manage.

Requête

Paramètres de chemin

string
requis
Identifiant du webhook (UUID).

Paramètres du corps

Le corps est facultatif.
boolean
défaut:"false"
true révoque immédiatement le secret actuel, par exemple après une fuite.

Réponse

En cas de succès, l’API renvoie 200 OK avec le webhook et son nouveau secret.
string
requis
Le secret de signature, whsec_ suivi de base64. Aniva ne l’affiche que dans cette réponse. Voir Vérifier la signature.
string
requis
Identifiant du webhook (UUID).
string
requis
L’URL HTTPS vers laquelle Aniva envoie les événements.
string
Texte libre pour ta propre référence. Peut être null.
string[]
requis
Types d’événements que ce webhook reçoit. * signifie tous les types.
string[]
requis
Adresses auxquelles Aniva envoie un e-mail lorsque les livraisons continuent d’échouer.
string
requis
enabled ou disabled.
string
Instant ISO 8601 UTC de désactivation du webhook. null tant qu’il est activé.
string
Raison de la désactivation du webhook. Voir Avis d’échec. null tant qu’il est activé.
string
Instant ISO 8601 UTC de début de la série d’échecs actuelle. null lorsque la dernière livraison a réussi.
string
Instant ISO 8601 UTC auquel le secret précédent cesse de signer. null lorsqu’aucune rotation n’est en cours.
string
requis
Instant ISO 8601 UTC de création du webhook.
string
requis
Instant ISO 8601 UTC de la dernière modification.

Réponses d’erreur