# 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="../../autenticacao" %}
[autenticacao](https://docs.cange.me/api/autenticacao)
{% 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="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FG0v8ncSlNKzm7mPdiIjl%2FScreenshot%202024-10-09%20at%2018.49.11.png?alt=media&#x26;token=ed44b12e-6cdc-4142-96bf-07b7b368312a" 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="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2FBtd6cRDHoKfhPDpAZQXE%2FScreenshot%202024-10-09%20at%2018.50.27.png?alt=media&#x26;token=4a33f3ac-1a74-4192-ab15-a21eda5915bf" 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="https://3455492266-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRwVy0iUEFA554Gv29SpL%2Fuploads%2F4gxFilM0g8Otyr9Z6KlA%2Fimage.png?alt=media&#x26;token=11b382f1-352b-498f-9c96-c7b4346b2556" 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 %}