Skip to main content
POST
Create tag value

Headers

x-api-key
string | null

Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

Body

application/json

Body for POST /v1/tag-values: register a grouped label before any workflow uses it. The label shows a zero workflow count until applied.

key
string
required

Tag key (group) for the new label.

value
string
required

Tag value (label) to register under the key.

color
string | null

Palette color name for the label; a random palette color when omitted.

Response

Successfully registered tag value

Tag-value color registry entry: the palette color assigned to a grouped (key, value) pair.

key
string
required
value
string
required
color
string
required
workflow_count
integer
default:0

Number of non-deleted workflows currently carrying this (key, value) label.