# Tags

{% openapi src="<https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json>" path="/api/v3/tags" method="get" %}
[UshahidiV3.json](https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json)
{% endopenapi %}

## Add tag

<mark style="color:green;">`POST`</mark> `ushahididocs.api.ushahidi.io/api/v3/tags`

#### Request Body

| Name        | Type    | Description                              |
| ----------- | ------- | ---------------------------------------- |
| parent\_id  | integer | Parent identifier for Tag                |
| icon        | String  | Tag icon name                            |
| description | String  | Tag description                          |
| color       | String  | Tag color                                |
| type        | String  | Type of tag                              |
| tag         | String  | Tag name                                 |
| role        | Array   | Tag role                                 |
| priority    | Integer | Tag priority value                       |
| children    | Array   | An array of other dependent children tag |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "id": 0,
  "url": "string",
  "parent_id": "string",
  "tag": "string",
  "slug": "string",
  "type": "string",
  "color": "string",
  "icon": "string",
  "description": "string",
  "priority": 0,
  "created": "string",
  "role": [
    "string"
  ],
  "children": [
    "string"
  ],
  "allowed_privileges": [
    "string"
  ]
}
```

{% endtab %}
{% endtabs %}

## Edit tag

<mark style="color:orange;">`PUT`</mark> `ushahididocs.api.ushahidi.io/api/v3/tags/2`

#### Request Body

| Name        | Type    | Description                              |
| ----------- | ------- | ---------------------------------------- |
| parent\_id  | Integer | Parent identifier for Tag                |
| icon        | String  | Tag icon name                            |
| description | String  | Tag description                          |
| color       | String  | Tag color                                |
| type        | String  | Type of tag                              |
| tag         | String  | Tag name                                 |
| role        | Array   | Tag role                                 |
| priority    | Integer | Tag priority value                       |
| children    | Array   | An array of other dependent children tag |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "id": 0,
  "url": "string",
  "parent_id": "string",
  "tag": "string",
  "slug": "string",
  "type": "string",
  "color": "string",
  "icon": "string",
  "description": "string",
  "priority": 0,
  "created": "string",
  "role": [
    "string"
  ],
  "children": [
    "string"
  ],
  "allowed_privileges": [
    "string"
  ]
}
```

{% endtab %}
{% endtabs %}

{% openapi src="<https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json>" path="/api/v3/tags/5" method="get" %}
[UshahidiV3.json](https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json)
{% endopenapi %}

{% openapi src="<https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json>" path="/api/v3/tags/5" method="delete" %}
[UshahidiV3.json](https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json)
{% endopenapi %}