Atualizar campos de fase do card

Atualiza os campos referentes à fase atual de um card.

Esta chamada substitui por completo o conjunto de campos de fase do card atual — não é uma atualização incremental. Enviar apenas um subconjunto dos campos da fase atual apaga (zera) os campos que não foram incluídos na chamada; para preservar valores já preenchidos, é necessário reenviá-los junto com os novos em toda chamada. Campos pertencentes ao formulário de entrada (start-form) incluídos neste mesmo array são ignorados silenciosamente — não são atualizados nem retornados na resposta, sem gerar erro.

O corpo da requisição não aceita a propriedade phaseId (nem no nível raiz, nem dentro de cada item de fields) — ela é sempre inferida a partir do campo e da fase atual do card; incluí-la retorna erro 400. Campos nativos preenchidos automaticamente a partir do formulário de entrada (por exemplo, nome, documento e valor solicitado do cliente) não podem ser alterados por esta via após a criação do card: a chamada é aceita (200), mas o valor não muda — para corrigir esses campos é necessário recriar o card.

curl --location --request PUT '/v1/flows//cards//fields' \ --header 'Content-Type: application/json' \ --data '{ "fields": [ { "id": "string", "value": null } ] }'

Atualizar campos de fase do card

Requisição

Respostas