# Delete a Tag

Removes a tag from the organization's tag list so it can no longer be applied to new entities. The tag is also removed from every entity it had previously been added to, which can take additional time to be reflected across the system. The tag is supplied as the URL-encoded `tag` query parameter rather than a path segment, because tag names may contain `/`. A category can only be deleted once no tags remain within it; attempting to delete a category that still has tags returns a conflict.

Endpoint: DELETE /v1/tags
Version: v1
Security: ApiKey

## Query parameters:

  - `tag` (string, required)

## Response 400 fields (application/json):

  - `type` (string)
    RFC reference for the error type

  - `title` (string)
    Human-readable summary of the error

  - `status` (integer)
    HTTP status code

  - `errors` (array)
    Detailed error messages for each validation failure

  - `trace_id` (string)
    Trace identifier for debugging