Atualizar Ficha Cadastral do card

PUT

/v1/cards/{cardId}

Atualiza os campos da Ficha Cadastral do card, endereçando o card diretamente pelo seu identificador — sem informar o flow no caminho.

O corpo da requisição segue o mesmo formato usado na criação do card: uma lista de campos, cada um identificado pelo seu identificador (UUID) e o respectivo valor.

Campos nativos preenchidos automaticamente a partir do formulário de entrada (por exemplo, nome, documento e valor solicitado do cliente) são imutáveis após a criação do card: uma tentativa de alterá-los por este endpoint retorna erro 500 — diferente do comportamento silencioso do endpoint de atualização de campos de fase, que aceita a chamada mas não altera o valor. Em ambos os casos, a única forma de corrigir esses valores é recriar o card com o valor correto desde a criação.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Ficha atualizada

application/json

A Ficha Cadastral do card foi atualizada com sucesso.

Bodyapplication/json

🔴500Campo nativo imutável

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Exemplo 1

{
    "fields": [
        {
            "id": "string",
            "value": null
        }
    ]
}

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

Página anterior

Remover cards em lote

Próxima página

Obter responsável do card