---
title: "Create a tag"
method: POST
path: "/tags"
tags: ["Tags"]
---

# Create a tag

`POST /tags`

Creates a tag in the workspace.

The name is trimmed before being stored. Tag names are unique within the workspace, so reusing an existing name returns `409`.

## Request body

- object
  - `name` string, required — Name of the tag. Must be unique within the workspace

## Response `201`

Tag created successfully

- object
  - `id` string, uuid, required — Id of the tag
  - `name` string, required — Name of the tag

## Other responses

- `400` — Bad request, invalid input data
- `401` — Unauthorized
- `409` — A tag with the given name already exists

## Changes

- **2026-07-28** `8ccfb9a461e2` — 4 breaking, 2 warning, 5 info
  - request body became required
  - the request property `name` became required
  - the `name` request property's minLength was increased from `0` to `1`
  - removed the media type `application/json` for the response with the status `409`
  - …7 more

[Change history](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/changes/tags/post.md)

---

[API](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api.md) · [All operations](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/indigohive/cogfy-messenger-public-api/revisions/30bd33ee45c9/schema)