Skip to main content
POST
/
v1
/
agents
/
{workflow_permanent_id}
/
tags
Apply agent tags
curl --request POST \
  --url https://api.skyvern.com/v1/agents/{workflow_permanent_id}/tags \
  --header 'Content-Type: application/json' \
  --data '
{
  "tags": [
    {
      "value": "<string>",
      "key": "<string>"
    }
  ],
  "tags_to_delete": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "colors": {}
}
'
{
  "workflow_permanent_id": "<string>",
  "tags": [
    {
      "value": "<string>",
      "source": "<string>",
      "set_at": "2023-11-07T05:31:56Z",
      "set_by": "<string>",
      "key": "<string>"
    }
  ]
}

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

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