Atualizar filtro salvo

PUT

/v1/flows/{id}/filters

Atualiza o filtro salvo do usuário autenticado para o flow informado, substituindo integralmente a ordenação, o limite, a projeção de campos e as condições anteriores pelo conteúdo enviado.

Assim como na criação, o campo userId não deve ser enviado no corpo da requisição — a API o rejeita com erro 400, pois o dono do filtro é sempre resolvido a partir do token de autenticação. Use este endpoint para alterar um filtro que já existe; para o primeiro filtro de um usuário em um flow, utilize a criação (POST).

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Filtro atualizado

application/json

O filtro salvo do usuário autenticado foi atualizado com sucesso, substituindo integralmente a configuração anterior.

Bodyapplication/json

🟠400Payload inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/v1/flows//filters' \
--header 'Content-Type: application/json' \
--data '{
    "limit": 100,
    "order": "asc",
    "orderBy": "card.title",
    "fields": [
        {
            "path": "card.title"
        },
        {
            "path": "card.code"
        }
    ],
    "conditions": {
        "logic": "AND",
        "conditions": [
            {
                "scope": "all",
                "path": "card.done",
                "operator": "eq",
                "value": false
            }
        ]
    }
}'

Response Example

200 - 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