Update card registration record

PUT

/v1/cards/{cardId}

Updates a card's registration record ("Ficha Cadastral") fields, addressing the card directly by its identifier — without specifying the flow in the path.

The request body follows the same shape used when creating the card: a list of fields, each identified by its identifier (UUID) and its value.

Native fields auto-filled from the entry form (for example, the client's name, document and requested amount) are immutable after the card is created: attempting to change them through this endpoint returns a 500 error — unlike the silent behavior of the phase-fields update endpoint, which accepts the call but does not change the value. In both cases, the only way to correct these values is to recreate the card with the correct value from the start.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Registration record updated

application/json

The card's registration record was successfully updated.

Bodyapplication/json

🔴500Immutable native field

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