v65

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0386234904.1 KB
Tags

Create tag value

Register a grouped tag (key, value) with a palette color before any workflow uses it. The label shows a zero workflow count until applied to a workflow.

post/v1/tag-values

Headers

x-api-keystring nullable

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

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

Request body

keystring required

Tag key (group) for the new label.

valuestring required

Tag value (label) to register under the key.

colorstring nullable

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

Response

Successfully registered tag value

keystring required
valuestring required
colorstring required
workflow_countinteger

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