Saltar al contenido principal

Uso

Sintaxis​

kobana <producto> <recurso> <metodo> [flags]
  • <producto> — banking, finance, billing, inbox, dunning, dashboards o kadu.
  • <recurso> — puede ser anidado: tasks, executions search, webhook-deliveries. Es el primer segmento después de /v1, con - en lugar de _.
  • <metodo> — la acción: list, get, create, update, delete, o el nombre de la acción del endpoint (run, cancel, replay).

La versión de la API nunca entra en el comando — la CLI resuelve la URL a partir de la spec OpenAPI embebida.

Los parámetros de URL y de query van en --params; el cuerpo de la solicitud va en --json. La CLI sabe por la especificación dónde va cada parámetro: id entra en la ruta, el resto en la query.

Toda la superficie se descubre con --help, en cualquier nivel:

kobana --help                       # products
kobana kadu --help                  # Kadu resources
kobana kadu tasks --help            # methods of a resource

Recursos de kadu​

RecursoDescripción
meQuién está detrás del token.
organizationsLa organización del token: nombre, zona horaria, tope mensual de costo y custom_metadata.
workspacesDominios de negocio de la organización. Cada workspace es un plugin del Kadu Playbook.
activitiesAgrupadores de tareas dentro de un workspace.
tasksLas skills ejecutables de la organización: registro, lanzamiento, verificación previa y el endpoint HTTP de lanzamiento.
executionsCada lanzamiento de una tarea, con logs, eventos, pendientes y búsqueda de texto.
memoriesMemoria de la organización: registros por entidad (entity_type + entity_value), en el alcance de la organización, de un workspace o de una actividad.
environmentsEntornos de ejecución (Producción, Sandbox…). Cada secret y programación pertenece a uno.
secretsCredenciales entregadas a las ejecuciones. El valor se guarda cifrado y nunca se devuelve.
schedulesEjecuciones recurrentes de una tarea en un entorno, por expresión cron.
filesArchivos de entrada (adjuntados al lanzamiento) y de salida (publicados por la ejecución).
repositoryEl Kadu Playbook de la organización y su sincronización.
usageTokens, costo y precio de las ejecuciones.
todosPendientes creados por las ejecuciones.
webhooksNotificaciones HTTP firmadas enviadas cuando ocurren eventos.
webhook-deliveriesHistorial y reenvío de las entregas de webhook.
operation-approvalsOperaciones solicitadas por un asistente por MCP que esperan la confirmación de la persona por enlace (solo lectura).
rolesRoles y los permisos agent.* que conceden.
usersMiembros de la organización.
membershipsVínculos de personas con la organización.
system-eventsEventos de la organización (los mismos que alimentan los webhooks).

Cada recurso tiene su propia página, con la tabla completa de comandos y ejemplos — vea el catálogo.

Ejemplos​

# Ejecuciones que fallaron o fueron canceladas en el mes
kobana kadu executions list \
  --params '{"status[in]": "failed,cancelled", "reference_date[gte]": "2026-10-01"}' \
  --fields "id,status,reference_date"

# Todas las páginas, un ítem por línea (NDJSON)
kobana kadu executions list --page-all --fields "id,status"

# Salida en tabla
kobana kadu tasks list --output-format table

# Guardar la respuesta en un archivo
kobana kadu tasks get --params '{"id": "TASK_ID"}' --output tarefa.json

Ejemplo: disparar y acompañar​

# 1. La tarea y el entorno
kobana kadu tasks list --fields "id,skill_slug,label"
kobana kadu environments list --fields "id,label"

# 2. Verificar que el entorno esté listo
kobana kadu tasks readiness --params '{"id": "TASK_ID"}'

# 3. Disparar (primero con --dry-run)
kobana kadu tasks run --dry-run --params '{"id": "TASK_ID"}' \
  --json '{"reference_date": "2026-10-30", "environment_id": "ENVIRONMENT_ID"}'

# 4. Acompañar la ejecución
kobana kadu executions get --params '{"id": "EXECUTION_ID"}' --fields "id,status"
kobana kadu executions events --params '{"id": "EXECUTION_ID"}'
kobana kadu executions logs --params '{"id": "EXECUTION_ID"}'

# 5. Resolver los pendientes que dejó
kobana kadu executions todos --params '{"id": "EXECUTION_ID"}'
kobana kadu todos update --params '{"id": "TODO_ID"}' --json '{"status": "resolved"}'

Próximos pasos​