Listar filtros salvos

GET

/v1/flows/{id}/filters

Retorna os filtros salvos do flow associados ao usuário autenticado.

Um filtro salvo representa uma visualização pré-configurada do kanban do flow — por exemplo, uma tela de cards filtrados por responsável ou por um intervalo de valores — persistida para reuso na interface. Isso é diferente de uma busca de cards: os endpoints de busca (/v1/filters/flows/{flowId}/search e /v1/filters/search) executam uma consulta pontual e retornam os cards encontrados, enquanto este endpoint apenas lê a configuração de filtro previamente salva.

Cada usuário possui no máximo um filtro salvo por flow. Não existe filtro compartilhado entre usuários nem rota administrativa para consultar o filtro de terceiros: o filtro retornado é sempre o do usuário autenticado, resolvido a partir do token utilizado na requisição.

Requisição

Parâmetros de Caminho

Respostas

🟢200Filtros retornados

application/json

Lista de filtros salvos do flow visíveis para o usuário autenticado. Como existe no máximo um filtro por combinação de flow e usuário, a lista normalmente contém zero ou um item.

Bodyapplication/json

Response Example

[
    {
        "id": "string",
        "flowId": "string",
        "userId": "string",
        "limit": 0,
        "order": "asc",
        "orderBy": "string",
        "fields": [
            {
                "path": "string"
            }
        ],
        "conditions": {
            "logic": "AND",
            "conditions": [
                {
                    "scope": "any",
                    "path": "string",
                    "operator": null,
                    "value": null
                }
            ]
        }
    }
]

Modificado em 2026-07-28 20:38:32

Página anterior

Filtros — Visão Geral

Próxima página

Criar filtro salvo