API de administración
Toda la administración de betool es accesible mediante una API REST autenticada. Este es el canal para la automatización: aprovisionamiento de organizaciones sobre la marcha, sincronización de pipelines desde tu repositorio Git, dashboards personalizados, integración ITSM.
Autenticación
Token Bearer emitido desde Administración → Tokens dentro de tu organización.
curl -H "Authorization: Bearer $BETOOL_TOKEN" \
https://platform.betool.ai/api/admin/me
El token está acotado a una organización y un rol. El rol determina lo que puedes leer y escribir.
Paginación y filtrado
Todos los endpoints de listado siguen la misma convención:
?limit=50(por defecto 25, máx. 200)?offset=0?sort=-created_at(prefijo-para orden descendente)- Filtros ad hoc:
?status=ok&created_after=2026-05-01
La respuesta incluye una cabecera X-Total-Count para la paginación sin cursor.
Endpoints principales
| Endpoint | Descripción |
|---|---|
GET /api/admin/me | Identidad, organización actual, rol |
GET /api/admin/pipelines | Listar pipelines |
POST /api/admin/pipelines | Crear un pipeline |
PATCH /api/admin/pipelines/{id} | Actualizar un pipeline |
GET /api/admin/pipelines/{id}/executions | Historial de ejecuciones |
GET /api/admin/billing/balance | Saldo de créditos |
POST /api/admin/billing/topup | Recarga manual |
GET /api/admin/me/content-reads | Registro de auditoría de accesos cross-tenant |
La documentación OpenAPI completa está disponible en /api/admin/openapi.json una vez autenticado.
Idempotencia
Los endpoints POST aceptan una cabecera Idempotency-Key. Si reenvías la misma solicitud con la misma clave, obtienes la misma respuesta — útil para las estrategias de reintento del lado del llamador.
Webhooks de salida
Configura betool para notificarte en eventos clave (ejecución fallida, saldo bajo, nuevo usuario). Consulta Webhooks de salida.
Rate limiting
Por defecto:
- 1000 solicitudes / minuto por token
- 100 solicitudes / minuto para los endpoints de escritura costosos (creación de pipelines, importación por lotes)
En el plan Enterprise, los límites son configurables.
SDK
No hay SDK oficiales (todavía). La API es lo bastante simple como para consumirla desde cualquier lenguaje con un cliente HTTP.
Si escribes un SDK para tu organización, avísanos — lo listaremos.