Skip to main content
Endpoints de listagem (GET /agents, GET /conversations, GET /clients, etc.) usam um único shape consistente: page + limit.

Requisição

Paginação inválida (page < 1, limit > 100) retorna 400 VALIDATION_ERROR.

Envelope da resposta

Toda resposta paginada envolve os items no mesmo shape:

Iterando por todas as páginas

Quando você não souber o total antes, dá pra parar assim que items voltar vazio. Mas sempre confira totalPages se precisar de comportamento consistente de fim-de-dados.

Filtros

A maioria dos endpoints de listagem aceita query parameters adicionais pra restringir resultado: Veja a página de cada endpoint na referência para a lista completa.

Ordenação estável

Resultados são ordenados por createdAt descendente (mais novos primeiro), exceto onde a documentação do endpoint especifique o contrário. Isso significa que recursos novos podem aparecer na primeira página durante iteração — se precisar de um snapshot estável, capture uma vez e guarde os IDs.