> ## Documentation Index
> Fetch the complete documentation index at: https://docs.herondata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a tag

> Delete a tag. It is removed from everything it is currently applied to and no longer appears in tag lists. Where your access is restricted by tag, you can only delete tags you hold. Where access is restricted by tag, a tag applied to any end user cannot be deleted: remove it from them first, since deleting it revokes access for everyone holding it.




## OpenAPI

````yaml https://app.herondata.io/swagger delete /api/tags/{heron_id}
openapi: 3.0.0
info:
  contact:
    email: support@herondata.io
    name: Support
  title: Heron Data API
  version: '2021-07-19'
servers:
  - description: Production
    url: https://app.herondata.io
security:
  - ApiKeyAuth:
      - key_XXX
externalDocs:
  description: Read Tutorial
  url: https://docs.herondata.io/
paths:
  /api/tags/{heron_id}:
    delete:
      tags:
        - Tags
      summary: Delete a tag
      description: >
        Delete a tag. It is removed from everything it is currently applied to
        and no longer appears in tag lists. Where your access is restricted by
        tag, you can only delete tags you hold. Where access is restricted by
        tag, a tag applied to any end user cannot be deleted: remove it from
        them first, since deleting it revokes access for everyone holding it.
      parameters:
        - in: path
          name: heron_id
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content
        '404':
          description: Tag not found
        '422':
          description: >-
            System-managed tag, outside your access scope, or applied to end
            users
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: x-api-key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.