Listagem, Ordenação e Filtros

As tools *_list usam a mesma paginação da API v1: por cursor (veja Paginação).

Argumento	Padrão	Regra
limit	25	de 1 a 100
cursor	—	o meta.next_cursor da página anterior

{ "name": "kadu_executions_list", "arguments": { "status": "failed", "limit": 50 } }

O resultado traz o envelope de sempre:

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

Repita a chamada com cursor igual ao next_cursor até ele vir null. O cursor é opaco: não o monte nem o interprete. Um cursor inválido volta VALIDATION_ERROR.

:::note Listas sem cursor Algumas listagens devolvem um conjunto fixo, e a tool correspondente não oferece cursor nem limit: as entregas de webhook (kadu_webhook_deliveries_list, as 50 mais recentes), os membros da organização (kadu_users_list, até 100), os eventos de sistema (kadu_system_events_list, os 100 mais recentes) e a busca de execuções (kadu_executions_search). Os eventos, logs e pendências de uma execução vêm inteiros e em ordem; para ler só os novos, passe after_sequence (kadu_executions_events_list) ou after_id (kadu_executions_logs_list). Isso é intencional: uma tool que anunciasse cursor numa rota que o ignora faria o modelo paginar para sempre uma lista que não anda. :::

Ordenação

Argumento	Valores	Padrão
sort_by	created_at, updated_at ou um campo filtrável do recurso	created_at
sort_order	asc ou desc	desc

{ "name": "kadu_executions_list", "arguments": { "sort_by": "created_at", "sort_order": "asc" } }

Um sort_by que o recurso não ordena volta VALIDATION_ERROR, como na API. Um sort_order que não é asc nem desc é recusado antes de chegar à rota, com VALIDATION_ERROR e a mensagem Invalid tool arguments.. kadu_operation_approvals_list não ordena: as aprovações vêm sempre das mais recentes para as mais antigas.

Filtros

Cada tool de listagem declara os filtros do recurso como argumentos com nome — o inputSchema dela diz quais são. Eles viram os filtros da API:

Forma do argumento	Exemplo	Vira
Um valor	status: "failed"	status=failed
Uma lista (até 100)	status: ["failed", "cancelled"]	status[in]=failed,cancelled
<campo>_gte / <campo>_lte	reference_date_gte: "2026-10-01"	reference_date[gte]=2026-10-01

{ "name": "kadu_executions_list",
  "arguments": { "status": ["failed", "cancelled"], "reference_date_gte": "2026-10-01", "limit": 50 } }

Um argumento que a tool não declara é descartado antes da chamada — o tamanho da página, por exemplo, não passa de 100 por dentro de um filtro.

Contrato de dados

O que vale para a API v1 vale aqui, porque é o mesmo código (veja Convenções):

• snake_case em tudo, argumentos e respostas.
• Datas em ISO 8601 em UTC; datas de referência em AAAA-MM-DD.
• Custo em dólares nos campos _usd; preço em reais nos campos _brl.
• Valores de secrets nunca voltam, por tool nenhuma.
• Escritas aceitam idempotency_key — veja Idempotência.