segmentV2SaveDraft
Save a draft segment-v2. Creates the definition on first call, or stages a
new draftVersion on an existing one. Validates the rule tree.
Publish the draft with segmentV2PublishVersion once
you’re ready to rebuild membership and start serving reads.
Side effects: Creates/updates the definition and a draft version row. Does not trigger a rebuild — publish first.
Auth · x-app-token · required permission manageSegments
Related: segmentV2PublishVersion, segmentV2PreviewCount
segmentV2SaveDraft(segmentId: String, name: String!, description: String, type: String, rule: JSON, emitsMembershipEvents: Boolean, usageState: String): JSONArguments
Existing segment id to update. Omit to create a new segment.
Display name.
Optional free-text description.
Segment kind — static or dynamic.
Targeting rule tree (JSON). Preview member impact with segmentV2PreviewCount before saving.
When true, membership changes emit events for downstream automations.
How this segment will be used.