Skip to main content
PATCH
/
v1
/
tag-values
/
{key}
/
rename
Rename tag value
curl --request PATCH \
  --url https://api.skyvern.com/v1/tag-values/{key}/rename \
  --header 'Content-Type: application/json' \
  --data '
{
  "value": "<string>",
  "new_value": "<string>"
}
'
{
  "key": "<string>",
  "value": "<string>",
  "color": "<string>",
  "renamed_workflow_count": 123
}

Headers

x-api-key
string | null

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

Path Parameters

key
string
required

Tag key (group)

Example:

"env"

Body

application/json

Body for PATCH /v1/tag-values/{key}/rename. Both the current and the new value ride in the body so values containing / stay addressable.

value
string
required

Current tag value (label) under the key to rename.

new_value
string
required

New tag value (label) to rename it to.

Response

Successfully renamed tag value

Response for PATCH /v1/tag-values/{key}/rename: the renamed label with its carried-over color and the number of workflows re-tagged.

key
string
required
value
string
required
color
string
required
renamed_workflow_count
integer
required