---
title: "List all tags"
method: GET
path: "/tags"
tags: ["Tags"]
---

# List all tags

`GET /tags`

## Request

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

List all tags

## Query parameters

- `type` 'file' | 'segment'
- `limit` integer
- `offset` integer

## Response `200`

List of tags

- ListVideoTagsResponse
  - `object` 'list', required: Object type, always 'list'
  - `total` integer, required: The total number of items
  - `limit` integer, required: The number of items per page
  - `offset` integer, required: The offset of the items
  - `data` VideoTag[]: The list of tags
    - `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

## Changes

- **2026-03-11** `1d5d6115c0d0`: 2 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
- **2025-12-18** `4a6898f33a3d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/tags/get.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)