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

# Create tag

`POST /tags`

Create a Tag in the team.

## Request body

- object
  - `data` object
    - `type` 'tags'
    - `attributes` object
      - `name` string, required — Name of the Tag
      - `description` string, nullable — Description of the Tag
      - `color` string, required — Color of the Tag

## Response `201`

Created

## Other responses

- `422` — Unprocessable Entity

## Changes

> 29 revisions in range; 15 could not be searched.

- **2026-08-12** `f4ae32b3f69d` — 2 info
  - the `color` request property default value `#ffffff` was removed (media type: application/json)
  - the `color` request property default value `#ffffff` was removed (media type: application/vnd.api+json)
- **2026-08-05** `ae7dcb22727c` — 1 info
  - added the optional property `data/attributes/team/limits/prefix` to the response with the `201` status
- **2026-08-04** `018cb742936f` — 1 breaking, 1 info
  - the request property `data/attributes/name` became required
  - the request property `data/attributes/color` with a default value became required

[Change history](https://skmtc.dev/latitude/apis/latitude-sh-api/changes/tags/post.md)

---

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