# Criar uma etiqueta

As etiquetas são elementos fundamentais para categorizar e destacar cartões dentro dos fluxos de trabalho no Cange, facilitando a visualização, filtragem e priorização das tarefas em execução. Cada fluxo possui seu próprio conjunto de etiquetas, garantindo organização e contexto específico para cada processo.

Utilizar a API do Cange para criar etiquetas permite automatizar a criação desses marcadores diretamente a partir dos seus sistemas, promovendo consistência e escalabilidade na gestão dos processos.

Para criar uma etiqueta 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="/pages/9WZ3PW4K1WSS8OpsOrjm" %}
[Autenticação](/api/autenticacao.md)
{% endcontent-ref %}

## Realizando a chamada para criação de uma etiqueta

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

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

**Headers**

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

**Body**

| Name          | Type   | Description                                 |
| ------------- | ------ | ------------------------------------------- |
| `flow_id`     | number | Código identificador do fluxo               |
| `description` | string | Título da etiqueta                          |
| `color`       | string | Cor da etiqueta (Hexadecimal) Ex: "#4680B8" |

```
{
    "flow_id": 9000,
    "description": "Etiqueta teste",
    "color": "#4680B8"
}
```

**Response**

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

```json
{
    "flow_id": 9000,
    "description": "Etiqueta teste",
    "color": "#4680B8",
    "id_flow_tag": 15544
}
```

{% 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/criar-uma-etiqueta.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.