> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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 `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](https://docs.qwairy.co/fr/developers/integration-webhooks/verify-signatures.md#renouveler-le-secret).

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](https://docs.qwairy.co/fr/developers/integration-webhooks/overview.md) et [Écrire des données](https://docs.qwairy.co/fr/developers/writing-data.md).

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**Idempotency-Key** `string` *required*

Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.

**webhookId** `string` *required*

Identifiant de l’endpoint.

## Réponse

Renvoie `200`, 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](https://docs.qwairy.co/fr/developers/endpoints/webhooks/list.md).

## Requête et réponse synthétiques

```bash theme={null}
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"
```

```json theme={null}
{
  "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 |

Consultez [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md) pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie `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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.