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

# List tags

`GET /tags`

## Request

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

Returns tags available to the authenticated user. Pass `team_id` to list a team's tags — requires any of `posts.view`, `posts.create` or `posts.edit` for `type=post`, or `inbox.manage` for `type=inbox`. Omit `team_id` to list your personal tags.

## Query parameters

- `type` 'post' | 'inbox', required
- `team_id` integer

## Response `200`

Tag list

- Tag[]
  - `id` integer
  - `name` string
  - `color` string, nullable: Hex color. Any valid 6-digit hex color is accepted. Null/omitted for the default (uncolored) look.
  - `type` 'post' | 'inbox', nullable: Whether this is a post tag or an inbox tag. Null on tags created before this distinction existed — those are treated as inbox tags.
  - `user_id` integer, nullable
  - `team_id` integer, nullable: Set when the tag belongs to a team; omitted/null for personal tags.
  - `conversations_count` integer, nullable: Number of inbox conversations this tag is applied to. Only present for `type=inbox` tags; omitted for post tags, which can never be applied to a conversation.
  - `can_manage` boolean: Whether the requesting user can rename or delete this tag. Always true for a personal tag; for a team tag it reflects the team permission required to manage that tag type (`posts.edit` for `type=post`, `inbox.manage` for `type=inbox`) — a member who can only list or create team tags gets `false`.

## Other responses

- `403`: You do not have permission to access this team's tags.

---

[API](https://skmtc.dev/socialbu/apis/socialbu-api.md) · [All operations](https://skmtc.dev/socialbu/apis/socialbu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialbu/apis/socialbu-api/revisions/841b3ab0f671?raw)