Create saved filter

POST

/v1/flows/{id}/filters

Creates the saved filter of the authenticated user for the given flow — a pre-configured view of the kanban board, with its own sorting, field projection and conditions.

There is at most one saved filter per flow-and-user combination: a second attempt to create one for the same pair returns a 422 error, stating that the filter already exists. In that case, use the update operation (PUT) instead of creating a new one.

The identifier of the user who owns the filter is always inferred from the authentication token of the request. Sending the userId field in the request body returns a 400 error. To create a filter on behalf of another user, you must authenticate with that user's credentials — there is no administrative route for this.

This endpoint should not be confused with the card search endpoints (/v1/filters/flows/{flowId}/search and /v1/filters/search): those run a one-off query and return cards, while this endpoint only persists a view configuration for later reuse.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢201Filter created

application/json

The filter was created successfully and becomes the saved filter of the authenticated user for the flow.

Bodyapplication/json

🟠400Invalid payload

🟠422Filter already exists

Request Example

Shell

JavaScript

Java

Swift

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
            }
        ]
    }
}'

Response Example

201 - Exemplo 1

{
    "id": "string",
    "flowId": "string",
    "userId": "string",
    "limit": 0,
    "order": "string",
    "orderBy": "string",
    "fields": [
        "string"
    ],
    "conditions": {}
}

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