Tag

Field	Type	Behavior	Description
name	string	OUTPUT_ONLY	Resource name (tags/{id})
display_name	string	REQUIRED	Human-readable name shown in the UI
description	string		Optional description of the tag
color	string		Hex color string (e.g., #5E6AD2). Ignored for system tags.
system	boolean	OUTPUT_ONLY	True for firetiger:* tags (set by server)
create_time	timestamp	OUTPUT_ONLY	When the tag was created
update_time	timestamp	OUTPUT_ONLY	When the tag was last modified
delete_time	timestamp	OUTPUT_ONLY	When the tag was soft-deleted (null if active)

Example

{
  "name": "tags/production",
  "displayName": "Production",
  "description": "Agents monitoring production systems",
  "color": "#5E6AD2",
  "createTime": "2024-06-15T14:30:00Z",
  "updateTime": "2024-06-15T14:30:00Z"
}

System tags

System tags have names prefixed with firetiger: and are created by the system. They:

• Have system set to true
• Cannot be created, updated, or deleted via the API
• Are always displayed in grey in the UI (the color field is ignored)

Example system tag

{
  "name": "tags/firetiger:monitoring",
  "displayName": "Monitoring",
  "system": true,
  "createTime": "2024-01-01T00:00:00Z",
  "updateTime": "2024-01-01T00:00:00Z"
}