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

# Create a tag

`POST /tags`

## Request

- Base URL: `/api/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/tags`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required
  - `color` string

## Response `200`

OK

- object
  - `success` true, required
  - `msg` string, required
  - `data` Tag, required
    - `id` string, required
    - `teamId` string, required
    - `name` string, required
    - `color` string, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `409`: A tag with that name already exists
- `429`: Too many requests
- `500`: Internal server error

## Changes

- **2026-10-01** `e1e4b18d0319`: 2 breaking, 2 warning, 6 info
  - removed the required property `success` from the response with the `401` status
  - removed the required property `success` from the response with the `500` status
  - removed the optional property `data` from the response with the `401` status
  - removed the optional property `data` from the response with the `500` status
  - …6 more
- **2026-09-28** `1fa164246828`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/tags/post.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) - [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluewave-labs/apis/checkmate-api/revisions/4f4b0d97c1f9?raw)