Update an existing tag

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

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

curl -X POST "https://leadtime.app/api/public/tags/task/save" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "color": "blue",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "urgent"
}'

const response = await fetch("https://leadtime.app/api/public/tags/task/save", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "color": "blue",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "urgent"
})
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/tags/task/save",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "color": "blue",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "urgent"
},
)

{
  "color": "blue",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "isDeleted": false,
  "name": "urgent"
}