Criar filtro salvo

Cria o filtro salvo do usuário autenticado para o flow informado — uma visualização pré-configurada do kanban, com ordenação, projeção de campos e condições próprias.

Existe no máximo um filtro salvo por combinação de flow e usuário: uma segunda tentativa de criação para o mesmo par retorna erro 422, informando que o filtro já existe. Nesse caso, utilize a atualização (PUT) em vez de uma nova criação.

O identificador do usuário dono do filtro é sempre inferido a partir do token de autenticação da requisição. Enviar o campo userId no corpo da requisição retorna erro 400. Para criar um filtro em nome de outro usuário, é necessário autenticar-se com as credenciais dele — não existe rota administrativa para isso.

Este endpoint não deve ser confundido com os endpoints de busca de cards (/v1/filters/flows/{flowId}/search e /v1/filters/search): eles executam uma consulta pontual e retornam cards, enquanto este endpoint apenas persiste uma configuração de visualização para reuso posterior.

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

Criar filtro salvo

Requisição

Respostas