> For the complete documentation index, see [llms.txt](https://help.cleverapp.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cleverapp.pro/dlya-razrabotchikov/dokumentaciya-i-rabota-s-api/kontakty/tegi.md).

# Теги

{% hint style="warning" %}
Как правильно сформировать запрос?! Смотрим в [основах](/dlya-razrabotchikov/dokumentaciya-i-rabota-s-api/osnovy.md)
{% endhint %}

## Получить список тегов бота

<mark style="color:blue;">`GET`</mark> `https://app.cleverapp.pro/api/v1/getBotTags`

Этот метод позволяет получить список всех тегов для определенного бота.

#### Path Parameters

| Name                                      | Type    | Description |
| ----------------------------------------- | ------- | ----------- |
| bot\_id<mark style="color:red;">\*</mark> | integer | ID бота.    |

{% tabs %}
{% tab title="200: OK Запрос успешно обработан" %}

```
"data": [
  "Одежда",
  "Акция",
  "Горячий"
}
```

{% endtab %}
{% endtabs %}

## Получить список тегов контакта

<mark style="color:blue;">`GET`</mark> `https://app.cleverapp.pro/api/v1/getContactTags`

Этот метод позволяет получить список тегов контакта.

#### Path Parameters

| Name                                      | Type    | Description  |
| ----------------------------------------- | ------- | ------------ |
| bot\_id<mark style="color:red;">\*</mark> | integer | ID контакта. |

{% tabs %}
{% tab title="200: OK Запрос успешно обработан" %}

```javascript
{
  "data": [
    "Горячий", 
    "Реклама"
  ]
}
```

{% endtab %}
{% endtabs %}

## Привязать тег к контакту

<mark style="color:green;">`POST`</mark> `https://app.cleverapp.pro/api/v1/attachTagToContact`

Этот метод позволяет привязать тег к контакту по id или имени тега.

#### Request Body

| Name                                          | Type    | Description  |
| --------------------------------------------- | ------- | ------------ |
| contact\_id<mark style="color:red;">\*</mark> | integer | ID контакта. |
| tag\_id                                       | string  | Имя тега     |

{% tabs %}
{% tab title="204: No Content Запрос успешно обработан" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

## Отвязать тег от контакта

<mark style="color:green;">`POST`</mark> `https://app.cleverapp.pro/api/v1/detachTagFromContact`

Этот метод позволяет отвязать тег от контакта по id или имени тега.

#### Request Body

| Name        | Type   | Description  |
| ----------- | ------ | ------------ |
| contact\_id | string | ID контакта. |
| name        | string | Имя тега.    |

{% tabs %}
{% tab title="204: No Content Запрос успешно обработан" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}