# Criar um comentário

Os comentários são elementos fundamentais para garantir a comunicação e o alinhamento entre os membros da equipe dentro dos cartões no Cange. Eles permitem registrar observações, decisões e interações diretamente no contexto das tarefas em andamento, promovendo colaboração e rastreabilidade ao longo dos processos.

Utilizar a API do Cange para criar comentários possibilita integrar essa comunicação aos seus sistemas, automatizando registros e garantindo histórico centralizado das interações.

Para criar um comentário através da API, você precisará ter um token de acesso válido. Se ainda não possui o seu token, consulte nosso guia abaixo sobre como obter o token de autenticação.

{% content-ref url="../../autenticacao" %}
[autenticacao](https://docs.cange.me/api/autenticacao)
{% endcontent-ref %}

## Realizando a chamada para criação de um comentário

```http
https://api.cange.me/card-comment
```

<mark style="color:green;">`POST`</mark> `/card-comment`&#x20;

**Headers**

| Name          | Value                      |
| ------------- | -------------------------- |
| Content-Type  | `application/json`         |
| Origin        | `https://app.cange.me`     |
| Authorization | `Bearer <token de acesso>` |

**Body**

| Name          | Type      | Description                                                   |
| ------------- | --------- | ------------------------------------------------------------- |
| `card_id`     | number    | Código identificador do cartão                                |
| `flow_id`     | number    | Código identificador do fluxo                                 |
| `description` | string    | Conteúdo do comentário que será inserido                      |
| `mentions`    | number\[] | Array contendo o ID dos usuários que precisam ser notificados |

```
{
    "card_id": 453752315,
    "description": "Hello World",
    "flow_id": 1410123,
    "mentions": []
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "card_id": 453752315,
    "user_id": 6812321,
    "dt_created": "2025-10-03T17:49:17.000Z",
    "dt_last_update": "2025-10-03T17:49:17.000Z",
    "description": "Hello World",
    "fixed": "0",
    "id_card_comment": 115765
}
```

{% endtab %}
{% endtabs %}