---
search:
  tags:
    - tags
    - POST
seo:
  description: >-
    Updates an existing tag name and color. This endpoint allows you to rename…
    Reference for the POST /tags/{type}/save endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Update an existing tag
title: Update an existing tag
type: openapi-operation
---
Updates an existing tag name and color. This endpoint allows you to rename tags or change their visual appearance.

**What can be updated:**
- **Tag name**: Change the tag label (must be unique within the tag type, case-insensitive)
- **Tag color**: Set or change the predefined color code for visual organization

**How it works:**
- Provide the tag ID and new name (required)
- Optionally provide a predefined color code (e.g., "red", "blue", "green")
- The system validates that the new name does not conflict with existing tags
- The system validates that the color is one of the predefined values
- All entities using this tag will automatically reflect the changes

**Tag Colors:**
Tags use predefined color codes, not hex values. Available colors:
- `default` - Light gray (default color)
- `red` - Red
- `yellow` - Yellow
- `green` - Green
- `blue` - Blue
- `purple` - Purple
- `fuchsia` - Fuchsia
- `pink` - Pink
- `magenta` - Magenta

**Use cases:**
- Rename tags for better consistency
- Add or change colors for visual organization
- Standardize tag naming across the workspace
- Update a documentation tag used by documentation pages

**Color strategy tips:**
- Use green for active processes
- Use blue for customer-related items
- Use red for issues or urgent items

**Permission requirements:**
- Task tags: Requires Tasks.manageTags permission
- Project tags: Must be an employee (not organization member)
- Project component tags: Requires ProjectComponentsLibrary.edit OR Projects.manageComponents permission
- Project documentation tags: Requires Projects.manageDocumentation permission

<Operation source="api-reference" id="tagscontroller-save" />