---
url: https://next.zammad.org/it/reference/rest-api/tags.md
---

# Tag

## Ticket scope

### Elenca

Permesso richiesto: `ticket.agent` **o** `admin.tag`

Richiesta `GET` inviata: `/api/v1/tags?object=Ticket&o_id={ticket id}`

::: details

```json
// HTTP-Code 200 OK

{
  "tags": [
    "order",
    "complaint"
  ]
}

```

:::

### Aggiungi

Permesso richiesto: `ticket.agent` **o** `admin.tag`

Richiesta `POST` inviata: `/api/v1/tags/add`

::::: details

:::: tabs key:reqres

\=== Richiesta

```json
{
  "item": "{tag name}",
  "object": "Ticket",
  "o_id": "{ticket id}"
}

```

::: info
Questo creerà il tag se non esiste e l'utente ha il permesso
per farlo.
:::

\=== Risposta

```json
// HTTP-Code 201 Created

true

```

::::
:::::

### Rimuovi

Permesso richiesto: `ticket.agent` **o** `admin.tag`

Richiesta `DELETE` inviata: `/api/v1/tags/remove`

:::: details

::: tabs key:reqres

\=== Richiesta

```json
{
  "item": "{tag name}",
  "object": "Ticket",
  "o_id": "{ticket id}"
}

```

\=== Risposta

```json
// HTTP-Code 200 OK

true

```

:::
::::

## Administration scope

### Admin - list

Permesso richiesto: `admin.tag`

Richiesta `GET` inviata: `/api/v1/tag_list`

::: details

```json
// HTTP-Code 200 OK

[
  {
    "id": 1,
    "name": "order",
    "count": 0
  },
  {
    "id": 2,
    "name": "complaint",
    "count": 0
  },
  {
    "id": 3,
    "name": "printer problem",
    "count": 0
  }
]

```

:::

### Admin - create

Permesso richiesto: `admin.tag`

Richiesta `POST` inviata: `/api/v1/tag_list`

:::: details

::: tabs key:reqres

\=== Richiesta

```json
{
  "name": "tag 5"
}

```

\=== Risposta

```json
// HTTP-Code 200 OK

{}

```

:::
::::

### Admin - rename

Permesso richiesto: `admin.tag`

Richiesta `PUT` inviata: `/api/v1/tag_list/{tag id}`

:::: details

::: tabs key:reqres

\=== Richiesta

```json
{
  "name": "order"
}

```

\=== Risposta

```json
// HTTP-Code 200 OK

{}

```

:::
::::

### Admin - delete

Permesso richiesto: `admin.tag`

Richiesta `DELETE` inviata: `/api/v1/tag_list/{tag id}`

::: details

Risposta:

```json
// HTTP-Code 200 OK

{}

```

:::