# API des Tags

<Aside type="note">
Pour définir les valeurs des tags pour les HWID et les UserID, utilisez la méthode [/setTags](/fr/developer/api-reference/device-api#settags) de l'API Appareil.
</Aside>

## addTag

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

Crée un tag dans votre compte.

#### Corps de la requête

| Nom                                       | Type    | Description                                                                                              |
| ------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------- |
| auth\*     | string  | [Jeton d'accès API](/fr/developer/api-reference/api-identifiers/#api-access-token) depuis le Panneau de Contrôle Pushwoosh.                                                           |
| tag\*      | object  | Paramètres du tag.                                                                                          |
| tag.name\* | string  | Nom du tag.                                                                                                |
| tag.type\* | integer | Type de tag. Voir les valeurs possibles ci-dessous.                                                                     |
| tag.user\_specific | boolean | Si `true`, la valeur du tag est stockée au niveau de l'utilisateur et partagée entre tous les appareils d'un utilisateur lorsqu'elle est définie par UserID. Si `false` (par défaut), le tag est au niveau de l'appareil et défini par HWID. |

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



```json title="Exemple"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // requis. Jeton d'accès API depuis le Panneau de Contrôle Pushwoosh
    "tag": {
      "name": "TAG_NAME",           // requis.
      "type": 1,                    // requis. Voir les valeurs possibles ci-dessous
      "user_specific": false        // optionnel. true = tag au niveau de l'utilisateur (partagé entre tous les appareils) ; false = tag au niveau de l'appareil (par défaut)
    }
  }
}
```

**Types de valeurs de tag possibles :**

* 1 - Integer
* 2 - String
* 3 - List
* 4 - Date
* 5 - Boolean
* 6 - Decimal. Ex : 19.95
* 7 - Version. Ex : "1.0.0.0"



## deleteTag

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

Supprime complètement un tag avec toutes les informations associées de la base de données.

#### Corps de la requête

| Nom                                       | Type   | Description                                    |
| ------------------------------------------ | ------ | ---------------------------------------------- |
| auth\*     | string | [Jeton d'accès API](/fr/developer/api-reference/api-identifiers/#api-access-token) depuis le Panneau de Contrôle Pushwoosh. |
| tag\*      | object | Paramètres du tag.                                |
| tag.name\* | string | Nom d'un [tag](/fr/developer/api-reference/api-identifiers/#tag) à supprimer.                       |

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



```json title="Exemple"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // requis. Jeton d'accès API depuis le Panneau de Contrôle Pushwoosh
    "tag": {
      "name": "TAG_NAME"            // requis. Nom d'un tag à supprimer
    }
  }
}


```

## listTags

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

Récupère une liste des tags sur le compte.

#### Corps de la requête

| Nom                                   | Type   | Description                                    |
| -------------------------------------- | ------ | ---------------------------------------------- |
| auth\* | string | [Jeton d'accès API](/fr/developer/api-reference/api-identifiers/#api-access-token) depuis le Panneau de Contrôle 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="Exemple"
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // Jeton d'accès API depuis le Panneau de Contrôle Pushwoosh
  }
} 
```

**Types de tag :**

* 1 - Integer
* 2 - String
* 3 - List
* 4 - Date
* 5 - Boolean
* 6 - Decimal. Ex : 19.95
* 7 - Version. Ex : "1.0.0.0"