> ## 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.

# Unmerge Workspace Data Definition

> Unmerge source events or properties out of one canonical in the workspace's project. Leave
the sources out to unmerge every definition merged into the canonical.

> [!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 post /v1/workspaces/{workspace_id}/data-definitions/unmerge
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-definitions/unmerge:
    post:
      tags:
        - Workspaces
        - Data Definitions
      summary: Unmerge Workspace Data Definition
      description: >-
        Unmerge source events or properties out of one canonical in the
        workspace's project. Leave

        the sources out to unmerge every definition merged into the canonical.
      operationId: unmerge_workspace_data_definition
      parameters:
        - $ref: '#/components/parameters/WorkspaceIdPathParameter'
        - $ref: '#/components/parameters/MixpanelVersionHeader'
        - $ref: '#/components/parameters/IdempotencyKeyHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnmergeDataDefinitionRequest'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnmergeDataDefinitionResponse'
        '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
    IdempotencyKeyHeader:
      in: header
      name: Idempotency-Key
      required: false
      description: >-
        Optional, client-provided key guaranteeing the operation is idempotent
        on success: if a request is replayed, the response includes
        `Idempotent-Replayed: true`.


        Reusing a key with a different request body, or while a request with the
        same key is still in flight, returns a `409`.


        Use a unique, random value for each request (a UUID v4 works well).
      schema:
        type: string
        maxLength: 255
        title: Idempotency-Key
  schemas:
    UnmergeDataDefinitionRequest:
      additionalProperties: false
      description: >-
        Split ``sources`` back out of ``canonical``, all of one ``type``.
        Exactly one unmerge per

        request. Leave ``sources`` out to unmerge every definition merged into
        the canonical.
      properties:
        type:
          description: The kind of definition to unmerge.
          enum:
            - event
            - event_property
          title: Type
          type: string
        canonical:
          description: Name of the definition the sources unmerge out of.
          maxLength: 255
          minLength: 1
          title: Canonical
          type: string
        sources:
          anyOf:
            - items:
                maxLength: 255
                minLength: 1
                type: string
              maxItems: 100
              minItems: 1
              type: array
            - type: 'null'
          description: >-
            Names of the definitions to unmerge out of the canonical. Omit to
            unmerge every definition merged into it.
          title: Sources
      required:
        - type
        - canonical
      title: UnmergeDataDefinitionRequest
      type: object
    UnmergeDataDefinitionResponse:
      properties:
        canonical:
          $ref: '#/components/schemas/DataDefinitionRef'
          description: The definition the sources unmerged from.
        sources:
          description: The definitions unmerged from the canonical.
          items:
            $ref: '#/components/schemas/DataDefinitionRef'
          title: Sources
          type: array
      required:
        - canonical
        - sources
      title: UnmergeDataDefinitionResponse
      type: object
    DataDefinitionRef:
      properties:
        type:
          $ref: '#/components/schemas/EntityType'
          description: The kind of definition.
        id:
          description: The definition's ID.
          title: Id
          type: string
        name:
          description: The definition's name.
          title: Name
          type: string
      required:
        - type
        - id
        - name
      title: DataDefinitionRef
      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
    EntityType:
      enum:
        - event
        - custom_event
        - event_property
        - custom_property
        - metric
        - behavior
        - cohort
      title: EntityType
      type: string
    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

````