Busca global de cards

Executa uma busca de cards entre todos os flows acessíveis ao usuário autenticado, em vez de restringir a busca a um único flow. Use este endpoint quando a busca precisar abranger cards de mais de um flow simultaneamente; para restringir a busca a um flow específico, utilize o endpoint de busca por flow (/v1/filters/flows/{flowId}/search).

O envelope da requisição é exatamente o mesmo do endpoint de busca por flow: exige order, orderBy, fields (a projeção de caminhos retornada por card) e conditions, uma lista não vazia de nós de condição em árvore, com o campo scope (any, all ou sum) obrigatório em todo nó. A requisição não é paginada — page e pageSize não são aceitos e retornam erro 400 caso estejam presentes.

Como a busca abrange múltiplos flows, cada card retornado inclui o identificador do flow ao qual pertence, permitindo distinguir a origem dos resultados. Assim como na busca por flow, o uso de um caminho ou operador incompatível pode resultar em erro interno do servidor em vez de uma mensagem de validação — recomendamos consultar previamente os caminhos disponíveis antes de montar a busca.

Respostas

🟢200Cards encontrados

application/json

Lista de cards, de qualquer flow acessível ao usuário autenticado, que atendem às condições informadas, projetados pelos caminhos indicados em fields e ordenados conforme order/orderBy.

Bodyapplication/json

🟠400Envelope de busca inválido

🔴500Erro interno na avaliação da condição

curl --location '/v1/filters/search' \ --header 'Content-Type: application/json' \ --data '{ "order": "asc", "orderBy": "card.enteredCurrentPhaseAt", "fields": [ { "path": "card.title" }, { "path": "card.value" } ], "conditions": [ { "scope": "any", "path": "card.value", "operator": "gte", "value": 0 } ] }'

Busca global de cards

Requisição

Respostas