---
title: "Delete tag value"
method: DELETE
path: "/v1/tag-values/{key}"
tags: ["Tags"]
---

# Delete tag value

`DELETE /v1/tag-values/{key}`

Soft-delete a grouped tag (key, value) and remove that label from every workflow carrying it (cascade). The value rides in the body so values containing '/' stay addressable. Returns how many workflows the label was removed from.

## Path parameters

- `key` string, required — Tag key (group)

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Request body

- TagValueDelete — Body for ``DELETE /v1/tag-values/{key}``. The value rides in the body, not the path, so values containing ``/`` stay addressable.
  - `value` string, required — Tag value (label) under the key to soft-delete.

## Response `200`

Successfully deleted tag value

- TagValueDeleteResponse — Response for ``DELETE /v1/tag-values/{key}``.
  - `key` string, required
  - `value` string, required
  - `removed_from_workflow_count` integer, required
  - `removed_from_run_count` integer
  - `removed_count` integer

## Other responses

- `404` — Tag value not found
- `422` — Validation Error

---

[API](https://skmtc.net/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/versions/29562c6e0364/schema)