> For the complete documentation index, see [llms.txt](https://docs.cange.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cange.me/api/fluxos/etiquetas/adicionar-uma-etiqueta-em-um-cartao.md).

# Adicionar uma etiqueta em um cartão

Adicionar etiquetas a cartões no Cange é uma forma prática e visual de organizar, categorizar e destacar tarefas dentro de um fluxo de trabalho. Essa associação permite que times filtrem, priorizem e compreendam rapidamente o contexto de cada atividade.

Através da API do Cange, você pode vincular etiquetas a cartões de forma automatizada, integrando essa funcionalidade diretamente aos seus sistemas e fluxos externos, garantindo mais controle e padronização nos processos.

Para adicionar uma etiqueta a um cartão via API, é necessário possuir um token de acesso válido. Caso ainda não tenha o seu, consulte nosso guia abaixo sobre como obter o token de autenticação.

{% content-ref url="/pages/9WZ3PW4K1WSS8OpsOrjm" %}
[Autenticação](/api/autenticacao.md)
{% endcontent-ref %}

**Com esta requisição será possível adicionar uma etiqueta a um cartão.** Para ter acesso aos identificadores de cada objeto, siga os passos abaixo:

`flow_id`

Entre no Fluxo que deseja integrar e clique no ícone ↓ ao lado do nome do fluxo para abrir o menu suspenso, nele você poderá visualizar o identificador:

<figure><img src="/files/8mFBgWfMMsJHcaOTqUde" alt=""><figcaption></figcaption></figure>

`id_card`

Abra o cartão e clique no ícone "..." no canto superior direito para abrir o menu suspenso do cartão, nele você poderá visualizar o identificador:

<figure><img src="/files/Q02CQOXLprBiHaKGANfX" alt=""><figcaption></figcaption></figure>

`flow_tag_id`

Abra o menu de etiquetas dentro do cartão e clique no ícone de edição ("lápis"). Após isso, irá aparecer no topo da página o identificador da etiqueta selecionada.

<figure><img src="/files/nJv5rRRgFveMnZQZLSZs" alt=""><figcaption></figcaption></figure>

## Realizando a chamada para adicionar uma etiqueta em um cartão

```http
https://api.cange.me/flow-tag/card
```

<mark style="color:green;">`POST`</mark> `/flow-tag/card`&#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 formulário |
| `flow_tag_id` | number | Código identificador da etiqueta   |
| `flow_id`     | number | Código identificador do fluxo      |

```
{
    "flow_id": 9000,
    "card_id": 210721,
    "flow_tag_id": 15543
}
```

**Response**

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

```json
{
    "card_id": 210721,
    "flow_tag_id": 15543,
    "id_card_flow_tag": 156704
}
```

{% endtab %}
{% endtabs %}