Paginación, ordenación y filtros

Cursor

Los listados se paginan por cursor:

Parámetro	Predeterminado	Regla
limit	25	de 1 a 100
cursor	—	el meta.next_cursor de la página anterior

curl -H "Authorization: Bearer $KOBANA_TOKEN" \
  "https://api.kadu.ia.br/v1/executions?limit=50"

{
  "data": [ … ],
  "meta": { "next_cursor": "eyJpZCI6IjJmMWMi…", "limit": 50 }
}

Repite la llamada con cursor=<next_cursor> hasta que next_cursor venga null. El cursor es opaco: no lo armes ni lo interpretes. Un cursor inválido responde 400 VALIDATION_ERROR.

Ordenación

Parámetro	Predeterminado	Valores
sort_by	created_at	created_at, updated_at o un campo filtrable del recurso
sort_order	desc	asc o desc

Filtros

Cada recurso acepta filtros en campos específicos, con la forma campo=valor o campo[operador]=valor:

Operador	Ejemplo	Significado
(ninguno)	status=failed	igual
in	status[in]=failed,cancelled	uno de los valores, separados por coma
gte, lte, gt, lt	reference_date[gte]=2026-10-01	mayor o igual, menor o igual, mayor, menor
not	status[not]=success	distinto

Ejemplos de campos filtrables:

Recurso	Campos
/v1/tasks	workspace_id, activity_id, skill_slug (igual o in)
/v1/executions	task_id, workspace_id, activity_id, status (igual o in); reference_date, started_at (gte, lte)

Un operador que el campo no acepta responde 400 VALIDATION_ERROR. Un parámetro que no es un filtro del recurso se ignora.

curl -H "Authorization: Bearer $KOBANA_TOKEN" \
  "https://api.kadu.ia.br/v1/executions?status[in]=failed,cancelled&reference_date[gte]=2026-10-01&sort_order=asc"

Listas sin cursor

Algunos listados devuelven un conjunto fijo, sin paginación: las entregas de webhook (las 50 más recientes), los miembros de la organización (hasta 100) y los eventos de sistema (los 100 más recientes). La referencia de cada endpoint dice cuál es el caso.