> For the complete documentation index, see [llms.txt](https://docs.guardianservice.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guardianservice.app/technical-information/users/standard-registry-users-schemas-and-policies/policies/tagging/tagging-apis/creating-tag.md).

# Creating Tag

## Creates new tag.

<mark style="color:green;">`POST`</mark> `/tags`

Creates new tag.

#### Request Body

| Name                               | Type   | Description                           |
| ---------------------------------- | ------ | ------------------------------------- |
| <mark style="color:red;">\*</mark> | Object | Object that contains tag information. |

{% tabs %}
{% tab title="201: Created Successful Operation" %}

```
content:
            application/json:
              schema:
                $ref: "#/components/schemas/Tag"
```

{% endtab %}

{% tab title="400: Bad Request Bad Request" %}

```
content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
```

{% endtab %}

{% tab title="401: Unauthorized Unauthorized" %}

{% endtab %}

{% tab title="403: Forbidden Forbidden" %}

{% endtab %}

{% tab title="500: Internal Server Error Internal Server Error" %}

```
content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
```

{% endtab %}
{% endtabs %}