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

# Mettre à jour un endpoint de webhook

> Modifiez l’URL, la description, les événements, le filtre de workspaces ou l’activation d’un endpoint de webhook. Réactiver un endpoint efface son état d’échec.

Met à jour l’URL, la description, les événements, les workspaces ou l’activation d’un endpoint. N’envoyez que les champs à modifier. Réactiver un endpoint désactivé pour cause d’échecs efface son état d’échec.

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.

**If-Match** `string` *required*

L’`ETag` de [Obtenir un endpoint de webhook](https://docs.qwairy.co/fr/developers/endpoints/webhooks/get.md), guillemets compris. Utilisez `*` pour écrire sans condition.

**webhookId** `string` *required*

Identifiant de l’endpoint.

**url** `string`

URL HTTPS publique, 2048 caractères au maximum.

**description** `string | null`

Description libre, 200 caractères au maximum, ou `null` pour l’effacer.

**events** `string[]`

Liste de remplacement complète de [types d’événements](https://docs.qwairy.co/fr/developers/integration-webhooks/events.md), au moins un.

**brandIds** `string[]`

Liste de remplacement complète de 100 workspaces au maximum. Un tableau vide reçoit les événements de tous les workspaces.

**enabled** `boolean`

`false` met l’envoi en pause ; `true` le reprend.

Fournissez au moins un champ.

## Réponse

Renvoie `200`, le nouvel `ETag` et l’endpoint, avec les champs 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

Cet exemple suppose que l’`ETag` que vous avez lu en dernier est `"0"`.

```bash theme={null}
curl -X PATCH "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H 'If-Match: "0"' \
  -H "Content-Type: application/json" \
  -d '{"events":["run.completed","run.failed","run.cancelled"],"enabled":true}'
```

```json theme={null}
{
  "id": "eeeeeeee-0000-4000-8000-000000000000",
  "url": "https://hooks.example.com/qwairy",
  "description": "Production receiver",
  "events": ["run.completed", "run.failed", "run.cancelled"],
  "brandIds": [],
  "enabled": true,
  "disabledReason": null,
  "failingSince": null,
  "previousSecretExpiresAt": null,
  "version": 1,
  "createdAt": "2026-10-12T09:00:00.000Z",
  "updatedAt": "2026-10-12T10:00:00.000Z"
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_REQUEST` | Aucun champ, ou une valeur invalide |
| `404` | `RESOURCE_NOT_FOUND` | L’endpoint est absent ou appartient à une autre équipe |
| `412` | `PRECONDITION_FAILED` | L’endpoint a changé depuis votre lecture |
| `428` | `PRECONDITION_REQUIRED` | `If-Match` est absent |

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.