> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.flashid.app/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.flashid.app/_mcp/server.

# Tags

# Tags

Tags are Workspace-level labels that let you classify a profile across multiple dimensions. A
profile can have up to 20 tags, while each tag can be assigned to multiple profiles.

Use the Tags endpoints to list, create, update, or delete tags. Use the Profile Tag assignment
endpoints to add or remove one existing tag without replacing the profile's other assignments.

## Tag fields

| Field        | Description                                                                                |
| ------------ | ------------------------------------------------------------------------------------------ |
| `tag_uuid`   | Stable Tag UUID used by Tag and Profile endpoints.                                         |
| `name`       | Workspace-unique name. Leading and trailing whitespace is removed; maximum 100 characters. |
| `color_type` | Integer color identifier from 1 through 6.                                                 |

### Color types

| `color_type` | Color  |
| ------------ | ------ |
| `1`          | Purple |
| `2`          | Green  |
| `3`          | Blue   |
| `4`          | Orange |
| `5`          | Red    |
| `6`          | Grey   |

## Assign tags while writing a profile

Create profile and Update profile accept an optional `tag_uuids` array:

* On create, omit `tag_uuids` to create the profile without tags.
* On update, omit it to preserve the profile's current assignments.
* On update, send an empty array to remove all current assignments.
* Tag UUID order is preserved.

Quick update profile does not accept `tag_uuids`. Use Update profile or the single-assignment
endpoints instead.

Profile list items and profile details return `tags` as an array of `{ tag_uuid, name, color_type }`
objects in server order. Profiles without tags return an empty array.