---
updatedAt: 2026-10-25T15:46:36.000Z
agentTools:
  projectIndex: https://docs.superwise.ai/llms.txt
---

# Delete Tag

Delete tag.

Deletes one tag by its ID.

## When to use it

Use it to remove a tag from your account. To take a tag off one resource, use that resource's remove tags endpoint, such as [Remove tags from an agent](https://docs.superwise.ai/reference/delete_agent_tags).

## Required parameters

* `tag_id` (path): the ID of the tag.

## Response

A successful call returns `204 No Content` with an empty body.

**Related:** [List tags](https://docs.superwise.ai/reference/get_tags), [Remove tags from an agent](https://docs.superwise.ai/reference/delete_agent_tags), [Delete all tags](https://docs.superwise.ai/reference/delete_all_tags)

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "paths": {
    "/v1/tags/{tag_id}": {
      "delete": {
        "tags": [
          "Tags"
        ],
        "summary": "Delete Tag",
        "description": "Delete tag.",
        "operationId": "delete_tag",
        "parameters": [
          {
            "name": "tag_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid4",
              "title": "Tag Id"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "400": {
            "description": "Bad Request"
          },
          "404": {
            "description": "Not Found"
          },
          "422": {
            "description": "Unprocessable Entity"
          },
          "500": {
            "description": "Internal Server Error"
          }
        }
      }
    }
  },
  "info": {
    "title": "Superwise Main Entities",
    "description": "API reference",
    "version": "0.1.0"
  },
  "components": {
    "securitySchemes": {
      "implicit": {
        "type": "oauth2",
        "flows": {
          "implicit": {
            "authorizationUrl": "https://authentication.superwise.ai/identity/resources/auth/v1/api-token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "implicit": []
    }
  ],
  "servers": [
    {
      "url": "api.superwise.ai",
      "description": "Superwise Api Gateway"
    }
  ]
}
```