# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cange.me/api/fluxos/etiquetas/adicionar-uma-etiqueta-em-um-cartao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.