Update card

PATCH

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

Updates native card properties (for example, the deal's estimated value, or other top-level record properties) through a partial update — only the fields sent are changed.

This endpoint must not be used to move the card between phases: the phaseId field is not accepted in the request body, and its presence returns a 400 error. Every phase move must go exclusively through the move endpoint, which also validates that the current phase's required fields are filled in before allowing the card to leave it. Labels also cannot be changed through this endpoint — there is currently no label-write route in the API; labels are managed by automations configured on the flow.

Requisição

Parâmetros de Caminho

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Card updated

application/json

The card was successfully updated.

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