Tags

Tags are org-wide labels you can attach to agents, personas, metrics, test sets, runs, run templates, and uploaded conversations (for example with the --tags or --tag flags on those commands). Tag names are normalized to lowercase. create and update also accept --input-json (inline JSON, @file, or - for stdin); explicit flags override fields from the JSON. See Input JSON.

coval tags list

Output columns: ID, Name, Color, Created By, Created At

Get Tag

coval tags get <tag_id>

Argument	Type	Required	Description
`tag_id`	string	Yes	The tag ID

Create Tag

coval tags create [OPTIONS]

Option	Type	Required	Description
`--tag-name`	string	Yes	Tag display name. Normalized to lowercase
`--color`	string	No	Hex color code (`#RGB`, `#RRGGBB`, or `#RRGGBBAA`)

coval tags create --tag-name "regression" --color "#3b82f6"

Update Tag

coval tags update <tag_id> [OPTIONS]

Argument	Type	Required	Description
`tag_id`	string	Yes	The tag ID to update

Option	Type	Description
`--tag-name`	string	New name
`--color`	string	New hex color code

At least one of --tag-name or --color is required.

coval tags update 01HXYZ1234567890ABCDEF --color "#ef4444"

Delete Tag

coval tags delete <tag_id>

Argument	Type	Required	Description
`tag_id`	string	Yes	The tag ID to delete

Getting Started

Resources

Get Tag

Create Tag

Update Tag

Delete Tag

​List Tags

​Get Tag

​Create Tag

​Update Tag

​Delete Tag

List Tags

Get Tag

Create Tag

Update Tag

Delete Tag