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

# List Tags

`GET /tags`

List the tags of a project. Tags include user-created tags and Peec-managed system tags (is_system=true). Each tag carries a `group`: for system tags this is the mutually-exclusive dimension (branding or intentType); for user tags it is the user-defined group name (or null). Pass `group` to filter to a single user-defined group. System tags cannot be edited or deleted.

## Query parameters

- `project_id` string — Required if using a company api key
- `limit` number
- `offset` number
- `group` string — Filter to tags in this user-defined group (matches the `group` column exactly).

## Response `200`

Success

- object — Success
  - `data` object[], required
    - `id` string, required
    - `name` string, required
    - `is_system` boolean — Whether this is a system tag. System tags are maintained by Peec and auto-assigned to every prompt by its branding/intent classification; they cannot be created, edited, or deleted, but can be assigned to prompts.
    - `group` string, nullable, required — The group a tag belongs to, or null if ungrouped. For system tags this is the mutually-exclusive dimension "branding" (branded / non-branded) or "intentType" (informational / commercial / transactional) — every prompt carries exactly one tag per system group. For user tags it is the user-defined group name (e.g. "persona").
  - `total_count` number, required — Total number of matching tags, ignoring pagination
  - `totalCount` number, required — Total number of matching tags, ignoring pagination

---

[API](https://skmtc.dev/peec/apis/peec-ai-customer-api.md) · [All operations](https://skmtc.dev/peec/apis/peec-ai-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/peec/peec-ai-customer-api/revisions/92840a1bffa7/schema)