Skip to main content
POST
Apply agent tags

Headers

x-api-key
string | null

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

Path Parameters

workflow_permanent_id
string
required

Workflow permanent ID

Example:

"wpid_123"

Body

application/json

Body for POST /v1/workflows/{wpid}/tags. Either field may be empty (both empty is a no-op). On a same-identity collision, set wins over delete.

tags
TagInput · object[]

Tags to set (overwrite). List of {key?, value} objects.

tags_to_delete
TagDeleteInput · object[]

Tags to soft-delete. List of {key?, value?} targets.

colors
Colors · object | null

Optional map of grouped tag key to palette color name for the value being set. Keys absent from this map keep their existing color or receive a random palette color.

Response

Successfully applied tag changes

Current tags for a workflow. A list (not a key-map) so standalone labels, which have no key, are representable.

workflow_permanent_id
string
required
tags
TagResponse · object[]
required