begin_transaction
Destructive
Starts an undoable transaction grouping all subsequent edits into a single undo entry. Returns an index required by end or cancel operations for atomic rollback.
Instructions
Open one undoable transaction so a whole batch of edits collapses into a SINGLE undo entry: every Modify() between this and end_transaction joins it, and cancel_transaction rolls the lot back without leaving anything on the stack. Use it to make a multi-step edit atomically reversible; the returned transaction_index is what end_transaction / cancel_transaction need. already_open:true means one was already running -- transactions do not nest here.
Returns: { description: string, transaction_index: int, already_open: bool, undo_count: int }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | No | Label shown in the editor's undo history (e.g. 'MCP: retag turrets'). Make it recognisable; it is what get_transaction_history and next_undo report. | |
| primary_object_path | No | Optional object path recorded as the transaction's PrimaryObject, so the undo entry is attributable to one asset/actor. |