Atualizar fluxo

Atualiza os dados de um flow existente.

Este endpoint funciona como uma substituição completa (full-replace), não como uma atualização parcial: o payload deve conter o flow inteiro a cada chamada, mesmo quando o objetivo é alterar apenas um campo — por exemplo, somente labelOptions.

Os campos name, description, createCardLabel e cardCountLabel são sempre obrigatórios nesta operação, mesmo que seus valores não estejam mudando. Enviar description ausente ou vazia retorna erro 400.

Os campos color e icon também devem ser reenviados a cada chamada, mesmo sem alteração — omitir color retorna o erro 400 "color must be either a valid hexadecimal color (e.g., #FF5733) or one of the following: turquoise, blue, orange, violet, pink, purple, light_blue".

Atenção: omitir createCardLabel ou cardCountLabel NÃO gera erro — em vez disso, a API reseta silenciosamente esses campos para os valores padrão ('Novo Card' e 'cards', respectivamente), substituindo qualquer personalização anterior sem aviso. Recomendamos sempre obter o flow atual via GET antes de montar o payload do PUT, reenviando todos os campos existentes.

curl --location --request PUT '/v1/flows/' \ --header 'Content-Type: application/json' \ --data '{ "name": "string", "description": "string", "icon": "money", "color": "string", "createCardLabel": "string", "cardCountLabel": "string", "labelOptions": [ { "label": "string", "color": "string" } ] }'

{ "id": "string", "name": "string", "description": "string", "icon": "string", "color": "string", "createCardLabel": "string", "cardCountLabel": "string", "labelOptions": [ {} ] }

Atualizar fluxo

Requisição

Respostas