---
title: "Tag"
slug: "server-api-ticketing-tag"
updated: 2022-06-16T07:33:47Z
published: 2022-06-16T07:33:47Z
canonical: "developer.comm100.com/server-api-ticketing-tag"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.comm100.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tag

## Tag

Tag of the ticket.

- `Tag` - Tag Manage
  - `GET ticketing/tags` - [Get the list of Tag](/docs/server-api-ticketing-tag#get-the-list-of-tag)
  - `GET ticketing/tags/{id}` - [Get a single Tag](/docs/server-api-ticketing-tag#get-a-single-tag)
  - `POST ticketing/tags` - [Create a new Tag](/docs/server-api-ticketing-tag#create-a-new-tag)
  - `PUT ticketing/tags/{id}` - [Update the Tag](/docs/server-api-ticketing-tag#update-the-tag)
  - `DELETE ticketing/tags/{id}` - [Remove the Tag](/docs/server-api-ticketing-tag#remove-the-tag)

### Tag JSON Format

Tag is represented as simple flat JSON objects with the following keys:

| Name | Type | Description |
| --- | --- | --- |
| `id` | guid | Id of the tag. |
| `name` | string | Name of the tag. |

### Get the list of Tag

`GET ticketing/tags`

- #### Parameters:

No Parameters

- #### Response:

An array of [Tag](/docs/server-api-ticketing-tag#tag-json-format)

- #### Example

Sample Request:

```
curl https://api11.comm100.io/v4/ticketing/tags \ 
    -X 'GET' \ 
    -H 'Authorization: Bearer {access_token}' \
```

Response:

HTTP/1.1 200 OK

```
[
  {
      "id": "bdf96bad-890f-4af5-8f4e-42d2cc29e61b",
      "name": "my tag"
  }
]
```

### Get a single Tag

`GET ticketing/tags/{id}`

- #### Parameters:

No Parameters

- #### Response:

[Tag](/docs/server-api-ticketing-tag#tag-json-format)

- #### Example

Sample Request:

```
curl https://api11.comm100.io/v4/ticketing/tags/bdf96bad-890f-4af5-8f4e-42d2cc29e61b \ 
    -X 'GET' \ 
    -H 'Authorization: Bearer {access_token}' \
```

Response:

HTTP/1.1 200 OK

```
{
  "id": "bdf96bad-890f-4af5-8f4e-42d2cc29e61b",
  "name": "my tag"
}
```

### Create a new Tag

`POST ticketing/tags`

- #### Parameters:

| Name | Type | in | Required | Description |
| --- | --- | --- | --- | --- |
| `name` | string | body | yes | Name of the tag. |

- #### Response:

[Tag](/docs/server-api-ticketing-tag#tag-json-format)

- #### Example

Sample Request:

```
curl https://api11.comm100.io/v4/ticketing/tags \ 
    -X 'POST' \ 
    -H 'Authorization: Bearer {access_token}' \ 
    -H 'Content-Type: application/json' \ 
    -D '{"name":"my tag"}'
```

Response:

HTTP/1.1 201 Created

```
{
  "id": "bdf96bad-890f-4af5-8f4e-42d2cc29e61b",
  "name": "my tag"
}
```

### Update the Tag

`PUT ticketing/tags/{id}`

- #### Parameters:

| Name | Type | in | Required | Description |
| --- | --- | --- | --- | --- |
| `name` | string | body | yes | Name of the tag. |

- #### Response:

[Tag](/docs/server-api-ticketing-tag#tag-json-format)

- #### Example

Sample Request:

```
curl https://api11.comm100.io/v4/ticketing/tags/bdf96bad-890f-4af5-8f4e-42d2cc29e61b \ 
    -X 'PUT' \ 
    -H 'Authorization: Bearer {access_token}' \ 
    -H 'Content-Type: application/json' \ 
    -D '{"name":"my tag"}'
```

Response:

HTTP/1.1 200 OK

```
{
  "id": "bdf96bad-890f-4af5-8f4e-42d2cc29e61b",
  "name": "my tag"
}
```

### Remove the Tag

`DELETE ticketing/tags/{id}`

- #### Parameters:

No Parameters

- #### Response:

No Content

- #### Example

Sample Request:

```
curl https://api11.comm100.io/v4/ticketing/tags/bdf96bad-890f-4af5-8f4e-42d2cc29e61b \ 
    -X 'DELETE' \ 
    -H 'Authorization: Bearer {access_token}' \
```

Response:

HTTP/1.1 204 No Content