# Mutations operations

> Atomic mutation plan preview and execution.



3 operations. Names, descriptions, and behavior flags come from the canonical contract.

## Operations

- [`mutations.preview`](/document-api/reference/mutations/preview) (read): Dry-run a mutation plan, returning resolved targets without applying changes.
- [`mutations.apply`](/document-api/reference/mutations/apply) (mutates, tracked): Execute a mutation plan atomically against the document.
- [`plan.execute`](/document-api/reference/mutations/plan-execute) (mutates): Execute a compiled batch of plan-safe operation entries with per-entry transactions, capture resolution between entries, and keep-prefix-and-continue failure semantics.