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

# Delete Workspace Data Definition Tag

> Delete one of the data definition tags of the workspace's project and remove it from
every definition carrying it, including definitions outside the workspace's data view. The
definitions are otherwise unchanged.

> [!WARNING]
>
> **Closed Beta**\\
>
> Available to a limited set of invited customers. Contact your account team to join.
> The request and response contract may change before general availability (GA).


## OpenAPI

````yaml /openapi/platform.openapi.json delete /v1/workspaces/{workspace_id}/data-definition-tags/{tag_id}
openapi: 3.1.0
info:
  title: Mixpanel Platform API
  version: '1'
  description: ''
servers:
  - url: https://platform-us.mixpanel.com
    description: US
  - url: https://platform-eu.mixpanel.com
    description: EU
  - url: https://platform-in.mixpanel.com
    description: IN
security: []
paths:
  /v1/workspaces/{workspace_id}/data-definition-tags/{tag_id}:
    delete:
      tags:
        - Workspaces
        - Data Definitions
      summary: Delete Workspace Data Definition Tag
      description: >-
        Delete one of the data definition tags of the workspace's project and
        remove it from

        every definition carrying it, including definitions outside the
        workspace's data view. The

        definitions are otherwise unchanged.
      operationId: delete_workspace_data_definition_tag
      parameters:
        - in: path
          name: tag_id
          schema:
            title: Tag Id
            type: string
          required: true
        - $ref: '#/components/parameters/WorkspaceIdPathParameter'
        - $ref: '#/components/parameters/MixpanelVersionHeader'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteDataDefinitionTagResponse'
        '422':
          $ref: '#/components/responses/RequestValidationError'
        default:
          $ref: '#/components/responses/Error'
      security:
        - ServiceAccountAuth: []
components:
  parameters:
    WorkspaceIdPathParameter:
      in: path
      name: workspace_id
      schema:
        title: Workspace ID
        type: string
      required: true
      description: The unique identifier for the workspace.
    MixpanelVersionHeader:
      in: header
      name: Mixpanel-Version
      required: false
      description: >-
        Optional date-based API version pin.


        If omitted, the request is served by the **latest** API version, and the
        caller accepts that a future release may introduce a breaking change to
        the response contract. If set to a supported version date, that
        version's contract is honored and will not receive a breaking change.
      schema:
        default: '2026-08-13'
        type: string
        title: Mixpanel-Version
  schemas:
    DeleteDataDefinitionTagResponse:
      properties:
        deleted_at:
          description: When the tag was deleted.
          format: date-time
          title: Deleted At
          type: string
      required:
        - deleted_at
      title: DeleteDataDefinitionTagResponse
      type: object
    RequestValidationErrorResponse:
      properties:
        type:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: A stable reference that identifies the problem type, if applicable.
          title: Type
        status:
          description: >-
            The HTTP status code generated by the origin server for this
            occurrence of the problem.
          title: Status
          type: integer
        instance:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            A stable reference that identifies the specific occurrence of the
            problem, if applicable.
          title: Instance
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem, if applicable.
          title: Detail
        error_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Opaque identifier for this error occurrence. Include it when
            contacting support so the corresponding server-side error can be
            located.
          title: Error Id
        errors:
          anyOf:
            - items:
                $ref: '#/components/schemas/RequestValidationErrorItem'
              type: array
            - type: 'null'
          default: null
          description: The set of request validation errors.
          title: Errors
        title:
          description: A short, human-readable summary of the problem type.
          readOnly: true
          title: Title
          type: string
      required:
        - status
        - title
      title: RequestValidationErrorResponse
      type: object
    ErrorResponse:
      properties:
        type:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: A stable reference that identifies the problem type, if applicable.
          title: Type
        status:
          description: >-
            The HTTP status code generated by the origin server for this
            occurrence of the problem.
          title: Status
          type: integer
        instance:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            A stable reference that identifies the specific occurrence of the
            problem, if applicable.
          title: Instance
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem, if applicable.
          title: Detail
        error_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Opaque identifier for this error occurrence. Include it when
            contacting support so the corresponding server-side error can be
            located.
          title: Error Id
        title:
          description: A short, human-readable summary of the problem type.
          readOnly: true
          title: Title
          type: string
      required:
        - status
        - title
      title: ErrorResponse
      type: object
    RequestValidationErrorItem:
      properties:
        type:
          description: Machine-readable validation error type, e.g. 'missing'.
          title: Type
          type: string
        loc:
          description: Location of the offending value in the request.
          items:
            anyOf:
              - type: string
              - type: integer
          title: Loc
          type: array
        msg:
          description: Human-readable description of the error.
          title: Msg
          type: string
        ctx:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          default: null
          description: Additional context about the error, if any.
          title: Ctx
      required:
        - type
        - loc
        - msg
      title: RequestValidationErrorItem
      type: object
  responses:
    RequestValidationError:
      description: Request validation failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RequestValidationErrorResponse'
    Error:
      description: Error response.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    ServiceAccountAuth:
      type: http
      description: >-
        This endpoint uses [Service
        Account](https://docs.mixpanel.com/reference/service-accounts#authenticating-with-a-service-account)
        authentication.
      scheme: basic

````