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

# Delete tag key

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

Delete a tag key from the organization registry and remove that tag from every workflow that currently has it (cascade). Returns how many workflows the tag was removed from.

## Path parameters

- `key` string, required — Tag key to delete

## Headers

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

## Response `200`

Successfully deleted tag key

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

## Other responses

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

## Changes

- **2026-07-14** `1b9c7c96c010` — 3 info
  - added the new optional `header` request parameter `x-api-key`
  - added the optional property `removed_count` to the response with the `200` status
  - added the optional property `removed_from_run_count` to the response with the `200` status
- **2026-07-14** `66da0fa97dc5` — 3 warning
  - deleted the `header` request parameter `x-api-key`
  - removed the optional property `removed_count` from the response with the `200` status
  - removed the optional property `removed_from_run_count` from the response with the `200` status
- **2026-07-14** `1b9c7c96c010` — 3 info
  - added the new optional `header` request parameter `x-api-key`
  - added the optional property `removed_count` to the response with the `200` status
  - added the optional property `removed_from_run_count` to the response with the `200` status
- **2026-06-13** `e7044f43e57e` — 2 info
  - api tag `Tags` added
  - api tag `Workflow Tags` removed
- **2026-06-07** `e37d309fc58f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/skyvern-ai/apis/skyvern-api/changes/v1/tag-keys/:key/delete.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api.md) · [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api/revisions/1a7ff4f208ff/schema)