# API de Tags

<Aside type="note">
Para establecer valores de tags para HWIDs y UserIDs, utilice el método [/setTags](/es/developer/api-reference/device-api#settags) de la API de Dispositivos.
</Aside>

## addTag

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

Crea un tag en su cuenta.

#### Cuerpo de la solicitud

| Nombre | Tipo | Descripción |
| ------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------- |
| auth\* | string | [Token de acceso a la API](/es/developer/api-reference/api-identifiers/#api-access-token) desde el Panel de Control de Pushwoosh. |
| tag\* | object | Parámetros del tag. |
| tag.name\* | string | Nombre del tag. |
| tag.type\* | integer | Tipo de tag. Vea los valores posibles a continuación. |
| tag.user\_specific | boolean | Cuando es `true`, el valor del tag se almacena a nivel de usuario y se comparte entre todos los dispositivos de un usuario cuando se establece por UserID. Cuando es `false` (predeterminado), el tag es a nivel de dispositivo y se establece por HWID. |

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



```json title="Ejemplo"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // requerido. Token de acceso a la API desde el Panel de Control de Pushwoosh
    "tag": {
      "name": "TAG_NAME",           // requerido.
      "type": 1,                    // requerido. Vea los valores posibles a continuación
      "user_specific": false        // opcional. true = tag a nivel de usuario (compartido entre todos los dispositivos); false = tag a nivel de dispositivo (predeterminado)
    }
  }
}
```

**Posibles tipos de valor de tag:**

* 1 - Entero
* 2 - Cadena
* 3 - Lista
* 4 - Fecha
* 5 - Booleano
* 6 - Decimal. Ej: 19.95
* 7 - Versión. Ej: "1.0.0.0"



## deleteTag

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

Elimina completamente un tag con toda la información asociada de la base de datos.

#### Cuerpo de la solicitud

| Nombre | Tipo | Descripción |
| ------------------------------------------ | ------ | ---------------------------------------------- |
| auth\* | string | [Token de acceso a la API](/es/developer/api-reference/api-identifiers/#api-access-token) desde el Panel de Control de Pushwoosh. |
| tag\* | object | Parámetros del tag. |
| tag.name\* | string | Nombre de un [tag](/es/developer/api-reference/api-identifiers/#tag) para eliminar. |

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



```json title="Ejemplo"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // requerido. Token de acceso a la API desde el Panel de Control de Pushwoosh
    "tag": {
      "name": "TAG_NAME"            // requerido. Nombre de un tag para eliminar
    }
  }
}


```

## listTags

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

Recupera una lista de tags en la cuenta.

#### Cuerpo de la solicitud

| Nombre | Tipo | Descripción |
| -------------------------------------- | ------ | ---------------------------------------------- |
| auth\* | string | [Token de acceso a la API](/es/developer/api-reference/api-identifiers/#api-access-token) desde el Panel de Control de 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="Ejemplo"
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // Token de acceso a la API desde el Panel de Control de Pushwoosh
  }
} 
```

**Tipos de tag**:

* 1 - Entero
* 2 - Cadena
* 3 - Lista
* 4 - Fecha
* 5 - Booleano
* 6 - Decimal. Ej: 19.95
* 7 - Versión. Ej: "1.0.0.0"