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

# Lister les endpoints de webhook

> Listez les endpoints de webhook d’intégration de votre équipe, avec leurs événements, leurs filtres de workspaces, leur statut et la raison d’une désactivation.

Renvoie tous les endpoints de [webhook d’intégration](https://docs.qwairy.co/fr/developers/integration-webhooks/overview.md) de l’équipe. Le secret de signature n’est jamais renvoyé par une lecture.

Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Consultez [Webhooks d’intégration](https://docs.qwairy.co/fr/developers/integration-webhooks/overview.md).

**Authorization** `string` *required*

Jeton bearer de votre équipe.

## Réponse

**data** `array`

Les endpoints, chacun avec les champs ci-dessous.

**Endpoint**

**id** `string`

Identifiant de l’endpoint

**url** `string`

URL HTTPS publique complète qui reçoit les événements. Chaque clé qui peut lire les webhooks de l’équipe, clés en lecture seule comprises, la reçoit ; un jeton dans l’URL n’est donc pas un secret : vérifiez `X-Qwairy-Signature`

**description** `string | null`

Description libre, 200 caractères au maximum

**events** `string[]`

[Types d’événements](https://docs.qwairy.co/fr/developers/integration-webhooks/events.md) que l’endpoint reçoit

**brandIds** `string[]`

Workspaces auxquels l’endpoint est limité. Un tableau vide signifie tous les workspaces de l’équipe

**enabled** `boolean`

Indique si les événements sont envoyés

**disabledReason** `string | null`

`MANUAL`, `FAILING` ou `PLAN` lorsque l’endpoint est désactivé, sinon `null`

**failingSince** `string | null`

Date du premier échec de la série en cours au format ISO 8601

**previousSecretExpiresAt** `string | null`

Date à laquelle l’ancien secret de signature cesse d’être utilisé, après un renouvellement, au format ISO 8601

**version** `integer`

Valeur de concurrence opaque, envoyée dans `If-Match` pour la mise à jour et la suppression

**createdAt** `string`

Date de création au format ISO 8601

**updatedAt** `string`

Date de dernière mise à jour au format ISO 8601

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

```bash theme={null}
curl "https://www.qwairy.co/api/v1/webhooks" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "data": [
    {
      "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": null,
      "version": 0,
      "createdAt": "2026-10-12T09:00:00.000Z",
      "updatedAt": "2026-10-12T09:00:00.000Z"
    }
  ]
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `401` | Corps plat | Jeton absent ou invalide |
| `403` | `INSUFFICIENT_PLAN` | Refus d’offre générique : `"This endpoint is not included in the team's plan."` |

Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md). Sur `429`, respectez `Retry-After`.


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