Atualizar card

PATCH

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

Atualiza propriedades nativas do card (por exemplo, o valor estimado da oportunidade ou outras propriedades de topo do registro) por meio de uma atualização parcial — apenas os campos enviados são alterados.

Este endpoint não deve ser usado para mover o card entre fases: o campo phaseId não é aceito no corpo da requisição, e sua presença retorna erro 400. Toda movimentação de fase deve ser feita exclusivamente pelo endpoint de movimentação, que também valida se os campos obrigatórios da fase atual foram preenchidos antes de permitir a saída dela. Etiquetas também não podem ser alteradas por este endpoint — atualmente não existe uma rota de escrita de etiquetas na API; elas são geridas por automações configuradas no flow.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Card atualizado

application/json

O card foi atualizado com sucesso.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/v1/flows//cards/' \
--header 'Content-Type: application/json' \
--data '{
    "value": 0,
    "dueDate": "string"
}'

Response Example

{
    "id": "string",
    "flowId": "string",
    "currentPhaseId": "string",
    "title": "string",
    "value": 0,
    "done": true,
    "assignee": {
        "userId": "string",
        "userName": "string",
        "userEmail": "string"
    },
    "labels": [
        {
            "label": "string",
            "color": "string"
        }
    ],
    "fields": [
        {
            "id": "string",
            "value": null
        }
    ],
    "createdAt": "string"
}

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

Página anterior

Obter card

Próxima página

Atualizar responsável do card