Listar endpoints de webhook

GET /v1/webhook-endpoints · permiso webhook-endpoints:read · todos los planes

Devuelve los endpoints de webhook del entorno, del más reciente al más antiguo (order=asc para del más antiguo al más reciente), en páginas por cursor. La respuesta nunca contiene un secreto de firma. Los campos se describen en Obtener un endpoint de webhook.

Un entorno puede tener como máximo esta cantidad de endpoints habilitados: Free 3, Startup 20, Business 20, Enterprise 50. Los endpoints deshabilitados no cuentan.

Solicitud

Campo Tipo Obligatorio Descripción
limit query no De 1 a 100 elementos por página; por defecto 20.
after query no Cursor de list_metadata.after de la página anterior.
before query no Cursor de list_metadata.before; no se puede combinar con after.
order query no desc (por defecto) o asc. Un cursor solo funciona con el orden para el que se emitió.

Respuesta

200 OK. list_metadata.after es null en la última página; no hay recuento 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}
}

Errores

HTTP código Cuándo
400 invalid_cursor El cursor tiene un formato incorrecto, pertenece a otro entorno u otro orden de clasificación.
422 validation_failed Un parámetro de consulta no es válido (/limit, /order).
401 unauthenticated La credencial falta, no es válida o fue revocada.
403 insufficient_permissions La credencial no tiene webhook-endpoints:read.
429 rate_limited Se superó el límite de frecuencia; reintente después del período de Retry-After.
503 service_unavailable La administración de webhooks no está disponible temporalmente; reintente después del período de Retry-After.

Ejemplo

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

CLI: keenauth webhook-endpoints list --limit 20