# Tags-API

<Aside type="note">
Um Tag-Werte für HWIDs und UserIDs zu setzen, verwenden Sie die Methode [/setTags](/de/developer/api-reference/device-api#settags) aus der Device-API.
</Aside>

## addTag

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

Erstellt einen Tag in Ihrem Konto.

#### Request-Body

| Name                                       | Typ    | Beschreibung                                                                                              |
| ------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------- |
| auth\*     | string  | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) aus dem Pushwoosh Control Panel.                                                           |
| tag\*      | object  | Tag-Parameter.                                                                                          |
| tag.name\* | string  | Tag-Name.                                                                                                |
| tag.type\* | integer | Tag-Typ. Siehe mögliche Werte unten.                                                                     |
| tag.user\_specific | boolean | Wenn `true`, wird der Tag-Wert auf Benutzerebene gespeichert und über alle Geräte eines Benutzers geteilt, wenn er per UserID gesetzt wird. Wenn `false` (Standard), ist der Tag auf Geräteebene und wird pro HWID gesetzt. |

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



```json title="Beispiel"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME",           // erforderlich.
      "type": 1,                    // erforderlich. Siehe mögliche Werte unten
      "user_specific": false        // optional. true = Tag auf Benutzerebene (über alle Geräte geteilt); false = Tag auf Geräteebene (Standard)
    }
  }
}
```

**Mögliche Tag-Wert-Typen:**

* 1 - Ganzzahl (Integer)
* 2 - Zeichenkette (String)
* 3 - Liste
* 4 - Datum
* 5 - Boolescher Wert (Boolean)
* 6 - Dezimalzahl. Bsp: 19.95
* 7 - Version. Bsp: "1.0.0.0"



## deleteTag

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

Entfernt einen Tag mit allen zugehörigen Informationen vollständig aus der Datenbank.

#### Request-Body

| Name                                       | Typ   | Beschreibung                                    |
| ------------------------------------------ | ------ | ---------------------------------------------- |
| auth\*     | string | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) aus dem Pushwoosh Control Panel. |
| tag\*      | object | Tag-Parameter.                                |
| tag.name\* | string | Name eines zu löschenden [Tags](/de/developer/api-reference/api-identifiers/#tag).                       |

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



```json title="Beispiel"
{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // erforderlich. API-Zugriffstoken aus dem Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME"            // erforderlich. Name des zu löschenden Tags
    }
  }
}


```

## listTags

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

Ruft eine Liste der Tags im Konto ab.

#### Request-Body

| Name                                   | Typ   | Beschreibung                                    |
| -------------------------------------- | ------ | ---------------------------------------------- |
| auth\* | string | [API-Zugriffstoken](/de/developer/api-reference/api-identifiers/#api-access-token) aus dem Pushwoosh Control Panel. |

<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="Beispiel"
{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // API-Zugriffstoken aus dem Pushwoosh Control Panel
  }
} 
```

**Tag-Typen**:

* 1 - Ganzzahl (Integer)
* 2 - Zeichenkette (String)
* 3 - Liste
* 4 - Datum
* 5 - Boolescher Wert (Boolean)
* 6 - Dezimalzahl. Bsp: 19.95
* 7 - Version. Bsp: "1.0.0.0"