List saved filters

GET

/v1/flows/{id}/filters

Returns the saved filters of the flow associated with the authenticated user.

A saved filter represents a pre-configured view of the flow's kanban board — for example, a screen showing cards filtered by owner or by a value range — persisted for reuse in the interface. This is different from a card search: the search endpoints (/v1/filters/flows/{flowId}/search and /v1/filters/search) run a one-off query and return the matching cards, while this endpoint only reads a previously saved filter configuration.

Each user has at most one saved filter per flow. There is no filter shared between users and no administrative route to read another user's filter: the filter returned is always the one belonging to the authenticated user, resolved from the token used in the request.

Requisição

Parâmetros de Caminho

Respostas

🟢200Filters returned

application/json

List of saved filters of the flow visible to the authenticated user. Since there is at most one filter per flow-and-user combination, the list normally contains zero or one 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