> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whatabot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar Card

> Atualiza os valores ou tags de um card.

Atualiza os campos de um card existente.

<ParamField header="X-Api-Key" type="string" required>
  Sua chave de API (prefixada com `wh_`).
</ParamField>

<ParamField path="id" type="string" required>
  UUID do card.
</ParamField>

### Body

<ParamField body="values" type="object">
  Novos valores dos campos do card.
</ParamField>

<ParamField body="tags" type="string[]">
  Nova lista de tags (substitui as tags anteriores).
</ParamField>

### Exemplos de payload

<Tabs>
  <Tab title="Atualizar valores">
    ```json theme={null}
    {
      "values": {
        "amount": 3000.00,
        "status": "qualified"
      }
    }
    ```
  </Tab>

  <Tab title="Atualizar tags">
    ```json theme={null}
    {
      "tags": ["enterprise", "priority"]
    }
    ```
  </Tab>
</Tabs>

<RequestExample>
  ```bash theme={null}
  curl -X PATCH "https://api.whatabot.app/api/v1/kanban/cards/card-uuid" \
    -H "X-Api-Key: wh_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{"values": {"amount": 3000.00}, "tags": ["priority"]}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "card-uuid",
    "pipelineId": "pipeline-uuid",
    "stageId": "stage-uuid",
    "sessionId": "session-uuid",
    "tags": ["priority"],
    "values": {
      "name": "Maria Souza",
      "amount": 3000.00,
      "status": "qualified"
    },
    "createdAt": "2026-04-20T10:00:00.000Z",
    "movedAt": "2026-04-20T12:30:00.000Z"
  }
  ```
</ResponseExample>