Skip to main content
POST
Unmerge Workspace Data Definition
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).

Authorizations

Authorization
string
header
required

This endpoint uses Service Account authentication.

Headers

Mixpanel-Version
string
default:2026-08-13

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.

Idempotency-Key
string

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

Maximum string length: 255

Path Parameters

workspace_id
string
required

The unique identifier for the workspace.

Body

application/json

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.

type
enum<string>
required

The kind of definition to unmerge.

Available options:
event,
event_property
canonical
string
required

Name of the definition the sources unmerge out of.

Required string length: 1 - 255
sources
string[] | null

Names of the definitions to unmerge out of the canonical. Omit to unmerge every definition merged into it.

Required array length: 1 - 100 elements
Required string length: 1 - 255

Response

OK

canonical
DataDefinitionRef · object
required

The definition the sources unmerged from.

sources
DataDefinitionRef · object[]
required

The definitions unmerged from the canonical.