Lister les points de terminaison webhook

GET /v1/webhook-endpoints · autorisation webhook-endpoints:read · tous les forfaits

Renvoie les points de terminaison webhook de l'environnement, du plus récent au plus ancien (order=asc pour du plus ancien au plus récent), par pages à curseur. La réponse ne contient jamais de secret de signature. Les champs sont décrits dans Obtenir un point de terminaison webhook.

Un environnement peut avoir au maximum ce nombre de points de terminaison activés : Free 3, Startup 20, Business 20, Enterprise 50. Les points de terminaison désactivés ne sont pas comptés.

Requête

Champ Type Obligatoire Description
limit query non De 1 à 100 éléments par page ; 20 par défaut.
after query non Curseur tiré de list_metadata.after de la page précédente.
before query non Curseur tiré de list_metadata.before ; ne peut pas être combiné avec after.
order query non desc (par défaut) ou asc. Un curseur ne fonctionne qu'avec l'ordre pour lequel il a été émis.

Réponse

200 OK. list_metadata.after vaut null sur la dernière page ; il n'existe pas de nombre total.

{
  "data": [
    {
      "id": "whe_01k8a3m5q7t9v1w3x5y7z9b2c4",
      "key": "crm-sync",
      "url": "https://hooks.example.com/keenauth",
      "description": "CRM sync",
      "event_types": ["user.created", "user.updated"],
      "event_schema_versions": {},
      "payload_mode": "thin",
      "status": "enabled",
      "rate_limit_per_second": 50,
      "previous_secret_expires_at": null,
      "last_success_at": "2026-10-26T09:12:00Z",
      "failing_since": null,
      "version": 1,
      "created_at": "2026-10-26T09:00:00Z",
      "updated_at": "2026-10-26T09:00:00Z"
    }
  ],
  "list_metadata": {"before": null, "after": null}
}

Erreurs

HTTP code Quand
400 invalid_cursor Le curseur est mal formé, appartient à un autre environnement ou à un autre ordre de tri.
422 validation_failed Un paramètre de requête est invalide (/limit, /order).
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de webhook-endpoints:read.
429 rate_limited La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After.
503 service_unavailable L'administration des webhooks est temporairement indisponible ; réessayez après la durée indiquée par Retry-After.

Exemple

curl https://api.eu.keenauth.com/v1/webhook-endpoints?limit=20 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI : keenauth webhook-endpoints list --limit 20