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

# Create a new tag

`POST /tags`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/tags`
- Auth: HTTP bearer

Create a new tag

## Request body

- CreateVideoTagRequest
  - `label` string, required: The label of the tag
  - `value` string, required: The value of the tag
  - `file_id` string, uuid, required: The ID of the file
  - `segment_id` string, uuid: The ID of the segment

## Response `200`

Tag created successfully

- VideoTag
  - `id` string, uuid, required: The ID of the tag
  - `label` string, required: The label of the tag
  - `value` string, required: The value of the tag
  - `type` 'file' | 'segment', required: The type of the tag
  - `file_id` string, uuid, required: The ID of the file
  - `segment_id` string, uuid: The ID of the segment

## Other responses

- `400`: Invalid request or missing required label/value
- `403`: Usage limit reached (total tags per file or segment) — `code: usage_limit_reached`
- `404`: File not found
- `500`: An unexpected error occurred on the server

## Changes

- **2026-10-30** `23d3f240819f`: 5 info
  - added the non-success response with the status `403`
  - removed the non-success response with the status `429`
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `404` status
  - …1 more
- **2025-12-18** `4a6898f33a3d`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [All operations](https://skmtc.dev/cloudglue/apis/cloudglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudglue/apis/cloudglue-api/revisions/23d3f240819f?raw)