Atualizar campos via link público

PUT

/v1/flows/{id}/cards/{cardId}/fields/public

Atenção: usar este endpoint em um card que já avançou de fase pode apagar (zerar) todos os campos da fase atual do card, sem retornar nenhum erro HTTP — a resposta chega vazia e os dados de fase preenchidos anteriormente são perdidos. Esse comportamento foi observado ao tentar usá-lo para atualizar campos do formulário de entrada (start-form) de um card já existente: os campos do formulário de entrada não são atualizados (permanecem com o valor antigo) e os campos da fase atual são apagados.

Este endpoint destina-se exclusivamente ao fluxo de submissão pública inicial (o mesmo link, sem autenticação, usado para criar o card pela primeira vez). Para atualizar campos de um card já em andamento, utilize o endpoint autenticado de atualização de campos de fase, ou crie um novo card com os valores corretos.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Resposta da chamada

application/json

A API retorna 200 mesmo quando o efeito é o comportamento inesperado descrito acima — a resposta observada nesse cenário vem com a lista de campos vazia.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{
    "fields": [
        null
    ]
}

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

Página anterior

Atualizar responsável do card

Próxima página

Atualizar campos de fase do card