Criar fluxo

Cria um novo flow (processo de negócio) dentro da empresa autenticada.

Antes da criação do primeiro flow de uma empresa, é necessário que já exista uma logo cadastrada para o tenant — sem isso, a criação retorna erro 404 informando que a logo da empresa não foi encontrada.

O campo createButtonLabel não é aceito neste endpoint — ele pertence ao formulário de abertura (start form), não ao flow em si. Enviá-lo retorna erro 400. Para o rótulo do botão de criação de card, utilize createCardLabel.

Os campos createCardLabel e cardCountLabel são obrigatórios na prática, mesmo que a definição formal do schema não os apresente dessa forma: omiti-los, ou enviá-los como string vazia, retorna erro 400.

O campo color (cor de exibição do flow) aceita um código hexadecimal (#RRGGBB) ou um dos 7 valores nominais fixos: turquoise, blue, orange, violet, pink, purple, light_blue.

Já a cor de cada item em labelOptions deve ser sempre um código hexadecimal (#RRGGBB) — valores nominais como blue são rejeitados especificamente nesse campo, diferentemente da regra aplicada ao color do flow.

curl --location '/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": [ {} ] }

Requisição

Respostas