# API для тегов

<Aside type="note">
Чтобы установить значения тегов для HWID и UserID, используйте метод [/setTags](/ru/developer/api-reference/device-api#settags) из Device API.
</Aside>

## addTag

`POST` `https://api.pushwoosh.com/json/1.3/addTag`

Создает тег в вашем аккаунте.

#### Тело запроса

| Имя                                       | Тип    | Описание                                                                                              |
| ------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------- |
| auth\*     | string  | [Токен доступа к API](/ru/developer/api-reference/api-identifiers/#api-access-token) из панели управления Pushwoosh.                                                           |
| tag\*      | object  | Параметры тега.                                                                                          |
| tag.name\* | string  | Имя тега.                                                                                                |
| tag.type\* | integer | Тип тега. Возможные значения см. ниже.                                                                     |
| tag.user\_specific | boolean | Если `true`, значение тега хранится на уровне пользователя и является общим для всех его устройств при установке по UserID. Если `false` (по умолчанию), тег устанавливается на уровне устройства для каждого HWID. |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}
```
</TabItem>
</Tabs>



```json title="Пример"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // обязательно. Токен доступа к API из панели управления Pushwoosh
    "tag": {
      "name": "TAG_NAME",           // обязательно.
      "type": 1,                    // обязательно. Возможные значения см. ниже
      "user_specific": false        // необязательно. true = тег на уровне пользователя (общий для всех устройств); false = тег на уровне устройства (по умолчанию)
    }
  }
}
```

**Возможные типы значений тегов:**

* 1 - Целое число
* 2 - Строка
* 3 - Список
* 4 - Дата
* 5 - Логический
* 6 - Десятичное число. Пример: 19.95
* 7 - Версия. Пример: "1.0.0.0"



## deleteTag

`POST` `https://api.pushwoosh.com/json/1.3/deleteTag`

Полностью удаляет тег со всей связанной с ним информацией из базы данных.

#### Тело запроса

| Имя                                       | Тип   | Описание                                    |
| ------------------------------------------ | ------ | ---------------------------------------------- |
| auth\*     | string | [Токен доступа к API](/ru/developer/api-reference/api-identifiers/#api-access-token) из панели управления Pushwoosh. |
| tag\*      | object | Параметры тега.                                |
| tag.name\* | string | Имя [тега](/ru/developer/api-reference/api-identifiers/#tag) для удаления.                       |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "result": true
  }
}
```
</TabItem>
</Tabs>



```json title="Пример"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // обязательно. Токен доступа к API из панели управления Pushwoosh
    "tag": {
      "name": "TAG_NAME"            // обязательно. Имя тега для удаления
    }
  }
}


```

## listTags

`POST` `https://api.pushwoosh.com/json/1.3/listTags`

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

#### Тело запроса

| Имя                                   | Тип   | Описание                                    |
| -------------------------------------- | ------ | ---------------------------------------------- |
| auth\* | string | [Токен доступа к API](/ru/developer/api-reference/api-identifiers/#api-access-token) из панели управления Pushwoosh. |

<Tabs>
<TabItem label="200">
```json
{
  "status_code": 200,
  "status_message": "OK", 
  "response": {
    "tags": [{
      "name":"Language",
      "type":2
    }, {
      "name":"List tag",
      "type":3
    }]
  }
}
```
</TabItem>
</Tabs>



```json title="Пример"
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // Токен доступа к API из панели управления Pushwoosh
  }
} 
```

**Типы тегов**:

* 1 - Целое число
* 2 - Строка
* 3 - Список
* 4 - Дата
* 5 - Логический
* 6 - Десятичное число. Пример: 19.95
* 7 - Версия. Пример: "1.0.0.0"