## Add a tag to an item

`POST https://getkollek.com/api/items/{item}/tags`

Attach a tag to an item by name. When the account already has a tag with that name it is reused, matching regardless of case, so this never creates duplicates. Otherwise the tag is created first, then attached.

Attaching a tag the item already carries is accepted and changes nothing.

**Permissions:** Owners and editors. Viewers get a 404 response.

### Path parameters

- `item` (integer, required): The ID of the item.

### Body parameters

- `name` (string, required): The name of the tag to attach. Maximum 255 characters.

**Returns:** The attached tag object, whether it was reused or created.

### Example request

```bash
curl https://getkollek.com/api/items/1/tags \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Signed"
}'
```

### Example response

`Status: 201`

```json
{
    "data": {
        "type": "tag",
        "id": "1",
        "attributes": {
            "name": "Signed",
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/tags/1"
        }
    }
}
```