Renouveler le secret de signature
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId}/rotate-secret \
--header 'Authorization: <authorization>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}/rotate-secret"
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Idempotency-Key': '<idempotency-key>'}
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}/rotate-secret', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Endpoints de webhook
Renouveler le secret de signature
Générez un nouveau secret de signature pour un endpoint de webhook d’intégration. Pendant 24 heures, les envois portent deux signatures pour changer sans perte.
POST
https://www.qwairy.co
/
api
/
v1
/
webhooks
/
{webhookId}
/
rotate-secret
Renouveler le secret de signature
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId}/rotate-secret \
--header 'Authorization: <authorization>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}/rotate-secret"
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Idempotency-Key': '<idempotency-key>'}
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}/rotate-secret', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Renvoie un nouveau secret de signature, une seule fois. Pendant 24 heures après le renouvellement, chaque envoi porte deux signatures séparées par une virgule dans
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie
X-Qwairy-Signature : la nouvelle d’abord, puis l’ancienne. Les récepteurs peuvent déployer le nouveau secret sans perdre d’événements. Consultez Vérifier les signatures.
Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Modifier un endpoint exige aussi un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Webhooks d’intégration et Écrire des données.
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
Réponse
Renvoie200, le nouvel ETag et l’endpoint avec son nouveau secret. previousSecretExpiresAt indique l’heure à laquelle l’ancien secret cesse d’être utilisé. Les autres champs sont décrits dans Lister les endpoints de webhook.
Requête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID/rotate-secret" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Idempotency-Key: webhook-rotate-001"
{
"id": "eeeeeeee-0000-4000-8000-000000000000",
"url": "https://hooks.example.com/qwairy",
"description": "Production receiver",
"events": ["run.completed", "run.failed"],
"brandIds": [],
"enabled": true,
"disabledReason": null,
"failingSince": null,
"previousSecretExpiresAt": "2026-10-13T10:00:00.000Z",
"version": 2,
"createdAt": "2026-10-12T09:00:00.000Z",
"updatedAt": "2026-10-12T10:00:00.000Z",
"secret": "synthetic-new-signing-secret"
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
404 | RESOURCE_NOT_FOUND | L’endpoint est absent ou appartient à une autre équipe |
409 | IDEMPOTENCY_CONFLICT | La clé a été réutilisée avec une requête différente |
403 API_KEY_READ_ONLY. Sur 429, respectez Retry-After. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie 503 SERVICE_UNAVAILABLE et rien ne change.
