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

# List tags

`GET /tags`

## Request

- Base URL: `https://api.omnisocials.com/v1`
- URL: `https://api.omnisocials.com/v1/tags`
- Auth: HTTP bearer

Every tag of the workspace, by name. Tags label posts to filter and compare them: `tag` on GET /posts and GET /analytics/overview, and GET /analytics/tags.

## Response `200`

The workspace's tags

- object
  - `data` Tag[]
    - `id` integer
    - `name` string
    - `color` 'blue' | 'green' | 'orange' | 'red' | 'purple' | 'pink' | 'teal' | 'yellow' | 'brown' | 'gray'
    - `created_at` string, date-time

## Changes

- **2026-11-03** `46e479c09474`: 1 info
  - endpoint added

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

---

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