Edit the Playground canvas in one batch
playground_canvas_apply_operationsApply one atomic, revision-checked, idempotent batch of non-paid canvas edits: create_node (text, image, video, video-stitch, comment, image-compare, output-gallery, video-frame-grab, list-node), update_node, connect, disconnect, group, ungroup, delete and tidy. Refer to nodes created earlier in the batch as "$name". Nodes without a position are placed in free space beside what feeds them. Connections use the same handle rules as the browser; image → video accepts role first_frame, last_frame or reference; image-compare takes two images, output-gallery collects images, and video-frame-grab takes one clip (framePosition first or last). A list-node takes items (text, one per run); connect it to an image node and that node runs once per item when generated (set batchCombineMode cross or zip on the image node for two lists). The batch commits as one reversible revision, or nothing changes. It never starts generation. Returns the mutation receipt, updated revision and created or changed canvas references.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"expectedRevision": "<expectedRevision>",
"idempotencyKey": "<idempotencyKey>",
"operations": "<operations>"
},
"name": "playground_canvas_apply_operations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. | |
| operations | Yes | ||
| idempotencyKey | Yes | Unique key for this request; reuse only when retrying the identical request after a lost response. Use a new key after quoting or changing inputs. | |
| expectedRevision | Yes | Current canvas revision from canvas_read; on revision_conflict, read again and rebuild the change. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| created | Yes | ||
| summary | Yes | Human-readable summary of the applied canvas operations. | |
| replayed | Yes | ||
| revision | Yes |