---
title: "Create or update a tag"
method: PUT
path: "/tags"
---

# Create or update a tag

`PUT /tags`

Create a new tag or update an existing one. If a tag with this name already exists, it will be updated. Use exclude_from_auto_tagging to prevent the AI from auto-applying this tag.

## Request body

- UpsertTagInputDto
  - `tag_name` string, required — Tag name (e.g. "billing", "refund", "feature-request")
  - `description` string, nullable — Short description of what this tag means (max 160 chars)
  - `exclude_from_auto_tagging` boolean — If true, the AI will never auto-apply this tag (default: false)
  - `category_id` string, uuid, nullable — Assign the tag to a category (uuid), null to clear, omit to leave unchanged

## Response `200`

Default Response

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.dev/open/apis/opencx-api.md) · [All operations](https://skmtc.dev/open/apis/opencx-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/open/opencx-api/revisions/57b06b52302d/schema)