Skip to main content
Glama
Sign In

Mondovo

by com.mondovo.app
OverviewDiscussionsAdmin

Edit a video storyboard

edit_studio_video_storyboard
Destructive

Change the film's storyboard directly — FREE, applied at once, and undoable; nothing is made or charged (what a change costs shows on get_studio_video button, and only make_studio_video spends). Send ONE of: ops with the storyboard version you read as expected_version; undo: true with expected_version to take back the latest edit; or revert_turn: { turn_id, keep? } to take back what one studio_video_message turn changed (keep lists that turn's change ids to leave in place). Ops: set_creative_direction (visual_treatment realistic|animated|mixed|auto, presentation meme|standard|auto, meme_caption exact text, caption_placement top|bottom|auto: save creative choices free before making), edit_scene (scene_id + see / say / on_screen / seconds; on a filmed scene with somebody on camera, say is their line as the storyboard shows it, "Riley: …", and replaces it — it is never narration there; fit on a scene showing their clip: frame|pan|split|crop — a device frame, a pan across it, under the presenter, or cropped to its subject), remove_scene, reorder (scene_ids in the new order), set_music (off, track_id, energy upbeat|steady|calm, mood, volume 0–1, level quieter|louder), set_captions (on, style), set_caption_tier (scene_id + tier heading|body: that scene's spoken words emphasised in the captions, scene 1's also as the title at the top, or ordinary captions; filmed or photo scenes only), set_follow_stretch (scene_id + from + to: a scene that copies a video's moves follows another part of it — exactly one of that scene's follow.choices; the scene then reads changed and is made again on the button), redraw_storyboard (scene_id + optional note, e.g. "she holds the laptop lower": a filmed scene's storyboard — its storyboard_sheet_url — drawn again, free; the scene is then made from the new one), set_voice (source library|own + id, or voice_name; source none turns the narrating voice off — lines said on camera stay), set_voiceover (on: true|false), set_style (bold|elegant|playful|minimal — a feel; it never changes colours), set_colours (mode brand|designer|custom, and for custom hex as #rrggbb, most important first: the film's own colours, which every drawn scene and caption uses), trim_to (seconds, on its own), set_thing (thing_id + confirm or asset_id), add_scene_action (scene_id, action remake|change_person|change_thing|bring_to_life|cutaway|longer|language|redraw, note, asset_ids, language as a BCP-47 tag) — a paid change that goes on the button — and remove_scene_action, pick_script_option (option_id from storyboard.script_options), place_media (scene_id + asset_id: that scene shows one of THEIR files — a media[].id from add_studio_video_media or one already on the film — free; for a clip, optional from + to in seconds pick the stretch shown, else its first usable part as long as the scene), clear_media (scene_id + as filmed|drawn: the reverse — a scene showing their file becomes a filmed or drawn scene again, its words kept), insert_media_scene (after_scene_id, null for first, + asset_id: a new scene of their file), and set_format (aspect 9:16|4:5|1:1|16:9 and/or resolution 720p|1080p; before anything is made only the price moves, after it drawn scenes are redrawn and filmed scenes reframed, for free where the shot covers the new frame). If the storyboard changed since version, nothing is applied and the answer carries the current storyboard to try again against. Returns changes ({ id, summary }), the new version, and the storyboard and button.

Input Schema

NameRequiredDescriptionDefault
opsNo
undoNoTake back the latest edit
user_goalNoOptional: the user's goal behind this call, in one short sentence of plain words (e.g. "add a page so customers can book tables"). No names, emails or other personal details.
project_idYesProject id from create_motion_project. The bare project id or the library id ("studio-video:<uuid>" from list_creations / find_creation) both work.
revert_turnNo
expected_versionNostoryboard.version from get_studio_video (with `ops` or `undo`)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / user_goal
      Added value: +{
+  "description": "Optional: the user's goal behind this call, in one short sentence of plain words (e.g. \"add a page so customers can book tables\"). No names, emails or other personal details.",
+  "type": "string"
+}
  2. Changed1 schema field changed
    • changedInput schema / properties / ops / items / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "fit": {
-        "enum": [
-          "frame",
-          "pan",
-          "split",
-          "crop"
-        ],
-        "type": "string"
-      },
-      "footage_role": {
-        "description": "Filmed scene story role: main_action carries the central performance, including animals and objects; b_roll is an illustrative cutaway. Independent of speech or human presence.",
-        "enum": [
-          "main_action",
-          "b_roll"
-        ],
-        "type": "string"
-      },
-      "on_screen": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      },
-      "op": {
-        "const": "edit_scene",
-        "type": "string"
-      },
-      "say": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "scene_id": {
-        "maxLength": 40,
-        "minLength": 1,
-        "type": "string"
-      },
-      "seconds": {
-        "exclusiveMinimum": 0,
-        "maximum": 60,
-        "type": "number"
-      },
-      "see": {
-        "maxLength": 2000,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_scene",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "reorder",
-        "type": "string"
-      },
-      "scene_ids": {
-        "items": {
-          "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-        },
-        "maxItems": 40,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "op",
-      "scene_ids"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "energy": {
-        "enum": [
-          "upbeat",
-          "steady",
-          "calm"
-        ],
-        "type": "string"
-      },
-      "level": {
-        "enum": [
-          "quieter",
-          "louder"
-        ],
-        "type": "string"
-      },
-      "mood": {
-        "maxLength": 200,
-        "type": "string"
-      },
-      "off": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_music",
-        "type": "string"
-      },
-      "track_id": {
-        "maxLength": 120,
-        "type": "string"
-      },
-      "volume": {
-        "maximum": 1,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "on": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_captions",
-        "type": "string"
-      },
-      "style": {
-        "maxLength": 40,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "on"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_caption_tier",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "tier": {
-        "enum": [
-          "heading",
-          "body"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "tier"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "maximum": 3600,
-        "minimum": 0,
-        "type": "number"
-      },
-      "op": {
-        "const": "set_follow_stretch",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "to": {
-        "exclusiveMinimum": 0,
-        "maximum": 3600,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "from",
-      "to"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "note": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "redraw_storyboard",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "id": {
-        "maxLength": 200,
-        "type": "string"
-      },
-      "op": {
-        "const": "set_voice",
-        "type": "string"
-      },
-      "source": {
-        "enum": [
-          "library",
-          "own",
-          "none"
-        ],
-        "type": "string"
-      },
-      "voice_name": {
-        "maxLength": 60,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "on": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_voiceover",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "on"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_style",
-        "type": "string"
-      },
-      "style": {
-        "enum": [
-          "bold",
-          "elegant",
-          "playful",
-          "minimal"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "style"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "hex": {
-        "items": {
-          "pattern": "^#[0-9a-fA-F]{6}$",
-          "type": "string"
-        },
-        "maxItems": 6,
-        "minItems": 1,
-        "type": "array"
-      },
-      "mode": {
-        "enum": [
-          "brand",
-          "designer",
-          "custom"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_colours",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "trim_to",
-        "type": "string"
-      },
-      "seconds": {
-        "exclusiveMinimum": 0,
-        "maximum": 600,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "seconds"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "asset_id": {
-        "maxLength": 80,
-        "type": "string"
-      },
-      "confirm": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_thing",
-        "type": "string"
-      },
-      "thing_id": {
-        "maxLength": 120,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "thing_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "enum": [
-          "remake",
-          "change_person",
-          "change_thing",
-          "bring_to_life",
-          "cutaway",
-          "longer",
-          "language",
-          "redraw"
-        ],
-        "type": "string"
-      },
-      "asset_ids": {
-        "items": {
-          "maxLength": 80,
-          "type": "string"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "language": {
-        "maxLength": 20,
-        "type": "string"
-      },
-      "note": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "add_scene_action",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "still_preview_id": {
-        "maxLength": 80,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "enum": [
-          "remake",
-          "change_person",
-          "change_thing",
-          "bring_to_life",
-          "cutaway",
-          "longer",
-          "language",
-          "redraw",
-          "opening",
-          "sharper"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "remove_scene_action",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "pick_script_option",
-        "type": "string"
-      },
-      "option_id": {
-        "maxLength": 40,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "option_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "asset_id": {
-        "format": "uuid",
-        "type": "string"
-      },
-      "from": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "op": {
-        "const": "place_media",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "to": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "asset_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "as": {
-        "enum": [
-          "filmed",
-          "drawn"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "clear_media",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene_id": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "asset_id": {
-        "format": "uuid",
-        "type": "string"
-      },
-      "op": {
-        "const": "insert_media_scene",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "after_scene_id",
-      "asset_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aspect": {
-        "enum": [
-          "9:16",
-          "4:5",
-          "1:1",
-          "16:9"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_format",
-        "type": "string"
-      },
-      "resolution": {
-        "enum": [
-          "720p",
-          "1080p"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "caption_placement": {
-        "enum": [
-          "top",
-          "bottom",
-          "auto"
-        ],
-        "type": "string"
-      },
-      "meme_caption": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "set_creative_direction",
-        "type": "string"
-      },
-      "presentation": {
-        "enum": [
-          "meme",
-          "standard",
-          "auto"
-        ],
-        "type": "string"
-      },
-      "visual_treatment": {
-        "enum": [
-          "realistic",
-          "animated",
-          "mixed",
-          "auto"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "fit": {
+        "enum": [
+          "frame",
+          "pan",
+          "split",
+          "crop",
+          "backdrop"
+        ],
+        "type": "string"
+      },
+      "footage_role": {
+        "description": "Filmed scene story role: main_action carries the central performance, including animals and objects; b_roll is an illustrative cutaway. Independent of speech or human presence.",
+        "enum": [
+          "main_action",
+          "b_roll"
+        ],
+        "type": "string"
+      },
+      "on_screen": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "type": "array"
+      },
+      "op": {
+        "const": "edit_scene",
+        "type": "string"
+      },
+      "presenter_view": {
+        "description": "A scene the presenter talks under: corner keeps their own footage in the bottom-left corner over it (like a face cam); off gives the scene the whole frame.",
+        "enum": [
+          "corner",
+          "off"
+        ],
+        "type": "string"
+      },
+      "say": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "scene_id": {
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      },
+      "seconds": {
+        "exclusiveMinimum": 0,
+        "maximum": 60,
+        "type": "number"
+      },
+      "see": {
+        "maxLength": 2000,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_scene",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "reorder",
+        "type": "string"
+      },
+      "scene_ids": {
+        "items": {
+          "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+        },
+        "maxItems": 40,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "scene_ids"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "energy": {
+        "enum": [
+          "upbeat",
+          "steady",
+          "calm"
+        ],
+        "type": "string"
+      },
+      "level": {
+        "enum": [
+          "quieter",
+          "louder"
+        ],
+        "type": "string"
+      },
+      "mood": {
+        "maxLength": 200,
+        "type": "string"
+      },
+      "off": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_music",
+        "type": "string"
+      },
+      "track_id": {
+        "maxLength": 120,
+        "type": "string"
+      },
+      "volume": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "on": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_captions",
+        "type": "string"
+      },
+      "style": {
+        "maxLength": 40,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "on"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_caption_tier",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "tier": {
+        "enum": [
+          "heading",
+          "body"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "tier"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "maximum": 3600,
+        "minimum": 0,
+        "type": "number"
+      },
+      "op": {
+        "const": "set_follow_stretch",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "to": {
+        "exclusiveMinimum": 0,
+        "maximum": 3600,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "note": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "redraw_storyboard",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "maxLength": 200,
+        "type": "string"
+      },
+      "op": {
+        "const": "set_voice",
+        "type": "string"
+      },
+      "source": {
+        "enum": [
+          "library",
+          "own",
+          "none"
+        ],
+        "type": "string"
+      },
+      "voice_name": {
+        "maxLength": 60,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "on": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_voiceover",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "on"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_style",
+        "type": "string"
+      },
+      "style": {
+        "enum": [
+          "bold",
+          "elegant",
+          "playful",
+          "minimal"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "style"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "hex": {
+        "items": {
+          "pattern": "^#[0-9a-fA-F]{6}$",
+          "type": "string"
+        },
+        "maxItems": 6,
+        "minItems": 1,
+        "type": "array"
+      },
+      "mode": {
+        "enum": [
+          "brand",
+          "designer",
+          "custom"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_colours",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "trim_to",
+        "type": "string"
+      },
+      "seconds": {
+        "exclusiveMinimum": 0,
+        "maximum": 600,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "seconds"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "asset_id": {
+        "maxLength": 80,
+        "type": "string"
+      },
+      "confirm": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_thing",
+        "type": "string"
+      },
+      "thing_id": {
+        "maxLength": 120,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "thing_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "enum": [
+          "remake",
+          "change_person",
+          "change_thing",
+          "bring_to_life",
+          "cutaway",
+          "longer",
+          "language",
+          "redraw"
+        ],
+        "type": "string"
+      },
+      "asset_ids": {
+        "items": {
+          "maxLength": 80,
+          "type": "string"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "language": {
+        "maxLength": 20,
+        "type": "string"
+      },
+      "note": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "add_scene_action",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "still_preview_id": {
+        "maxLength": 80,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "enum": [
+          "remake",
+          "change_person",
+          "change_thing",
+          "bring_to_life",
+          "cutaway",
+          "longer",
+          "language",
+          "redraw",
+          "opening",
+          "sharper"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_scene_action",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "pick_script_option",
+        "type": "string"
+      },
+      "option_id": {
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "option_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "asset_id": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "from": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "op": {
+        "const": "place_media",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "to": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "asset_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "as": {
+        "enum": [
+          "filmed",
+          "drawn"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "clear_media",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene_id": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "asset_id": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "op": {
+        "const": "insert_media_scene",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "after_scene_id",
+      "asset_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aspect": {
+        "enum": [
+          "9:16",
+          "4:5",
+          "1:1",
+          "16:9"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_format",
+        "type": "string"
+      },
+      "resolution": {
+        "enum": [
+          "720p",
+          "1080p"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "caption_placement": {
+        "enum": [
+          "top",
+          "bottom",
+          "auto"
+        ],
+        "type": "string"
+      },
+      "meme_caption": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "set_creative_direction",
+        "type": "string"
+      },
+      "presentation": {
+        "enum": [
+          "meme",
+          "standard",
+          "auto"
+        ],
+        "type": "string"
+      },
+      "visual_treatment": {
+        "enum": [
+          "realistic",
+          "animated",
+          "mixed",
+          "auto"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  }
+]
  3. Changed3 schema fields changed
    • changedInput schema / properties / project_id / description
      Previous value: -"Project id from create_motion_project"New value: +"Project id from create_motion_project. The bare project id or the library id (\"studio-video:<uuid>\" from list_creations / find_creation) both work."
    • removedInput schema / properties / project_id / format
      Removed value: -"uuid"
    • addedInput schema / properties / project_id / pattern
      Added value: +"^(?:studio-video:)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
  4. Changed1 schema field changed
    • changedInput schema / properties / ops / items / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "fit": {
-        "enum": [
-          "frame",
-          "pan",
-          "split",
-          "crop"
-        ],
-        "type": "string"
-      },
-      "on_screen": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      },
-      "op": {
-        "const": "edit_scene",
-        "type": "string"
-      },
-      "say": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "scene_id": {
-        "maxLength": 40,
-        "minLength": 1,
-        "type": "string"
-      },
-      "seconds": {
-        "exclusiveMinimum": 0,
-        "maximum": 60,
-        "type": "number"
-      },
-      "see": {
-        "maxLength": 2000,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_scene",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "reorder",
-        "type": "string"
-      },
-      "scene_ids": {
-        "items": {
-          "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-        },
-        "maxItems": 40,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "op",
-      "scene_ids"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "energy": {
-        "enum": [
-          "upbeat",
-          "steady",
-          "calm"
-        ],
-        "type": "string"
-      },
-      "level": {
-        "enum": [
-          "quieter",
-          "louder"
-        ],
-        "type": "string"
-      },
-      "mood": {
-        "maxLength": 200,
-        "type": "string"
-      },
-      "off": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_music",
-        "type": "string"
-      },
-      "track_id": {
-        "maxLength": 120,
-        "type": "string"
-      },
-      "volume": {
-        "maximum": 1,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "on": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_captions",
-        "type": "string"
-      },
-      "style": {
-        "maxLength": 40,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "on"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_caption_tier",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "tier": {
-        "enum": [
-          "heading",
-          "body"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "tier"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "maximum": 3600,
-        "minimum": 0,
-        "type": "number"
-      },
-      "op": {
-        "const": "set_follow_stretch",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "to": {
-        "exclusiveMinimum": 0,
-        "maximum": 3600,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "from",
-      "to"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "note": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "redraw_storyboard",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "id": {
-        "maxLength": 200,
-        "type": "string"
-      },
-      "op": {
-        "const": "set_voice",
-        "type": "string"
-      },
-      "source": {
-        "enum": [
-          "library",
-          "own",
-          "none"
-        ],
-        "type": "string"
-      },
-      "voice_name": {
-        "maxLength": 60,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "on": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_voiceover",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "on"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_style",
-        "type": "string"
-      },
-      "style": {
-        "enum": [
-          "bold",
-          "elegant",
-          "playful",
-          "minimal"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "style"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "hex": {
-        "items": {
-          "pattern": "^#[0-9a-fA-F]{6}$",
-          "type": "string"
-        },
-        "maxItems": 6,
-        "minItems": 1,
-        "type": "array"
-      },
-      "mode": {
-        "enum": [
-          "brand",
-          "designer",
-          "custom"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_colours",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "trim_to",
-        "type": "string"
-      },
-      "seconds": {
-        "exclusiveMinimum": 0,
-        "maximum": 600,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "seconds"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "asset_id": {
-        "maxLength": 80,
-        "type": "string"
-      },
-      "confirm": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_thing",
-        "type": "string"
-      },
-      "thing_id": {
-        "maxLength": 120,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "thing_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "enum": [
-          "remake",
-          "change_person",
-          "change_thing",
-          "bring_to_life",
-          "cutaway",
-          "longer",
-          "language",
-          "redraw"
-        ],
-        "type": "string"
-      },
-      "asset_ids": {
-        "items": {
-          "maxLength": 80,
-          "type": "string"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "language": {
-        "maxLength": 20,
-        "type": "string"
-      },
-      "note": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "add_scene_action",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "still_preview_id": {
-        "maxLength": 80,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "enum": [
-          "remake",
-          "change_person",
-          "change_thing",
-          "bring_to_life",
-          "cutaway",
-          "longer",
-          "language",
-          "redraw",
-          "opening",
-          "sharper"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "remove_scene_action",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "pick_script_option",
-        "type": "string"
-      },
-      "option_id": {
-        "maxLength": 40,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "option_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "asset_id": {
-        "format": "uuid",
-        "type": "string"
-      },
-      "from": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "op": {
-        "const": "place_media",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "to": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "asset_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "as": {
-        "enum": [
-          "filmed",
-          "drawn"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "clear_media",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene_id": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "asset_id": {
-        "format": "uuid",
-        "type": "string"
-      },
-      "op": {
-        "const": "insert_media_scene",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "after_scene_id",
-      "asset_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aspect": {
-        "enum": [
-          "9:16",
-          "4:5",
-          "1:1",
-          "16:9"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_format",
-        "type": "string"
-      },
-      "resolution": {
-        "enum": [
-          "720p",
-          "1080p"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "caption_placement": {
-        "enum": [
-          "top",
-          "bottom",
-          "auto"
-        ],
-        "type": "string"
-      },
-      "meme_caption": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "set_creative_direction",
-        "type": "string"
-      },
-      "presentation": {
-        "enum": [
-          "meme",
-          "standard",
-          "auto"
-        ],
-        "type": "string"
-      },
-      "visual_treatment": {
-        "enum": [
-          "realistic",
-          "animated",
-          "mixed",
-          "auto"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "fit": {
+        "enum": [
+          "frame",
+          "pan",
+          "split",
+          "crop"
+        ],
+        "type": "string"
+      },
+      "footage_role": {
+        "description": "Filmed scene story role: main_action carries the central performance, including animals and objects; b_roll is an illustrative cutaway. Independent of speech or human presence.",
+        "enum": [
+          "main_action",
+          "b_roll"
+        ],
+        "type": "string"
+      },
+      "on_screen": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "type": "array"
+      },
+      "op": {
+        "const": "edit_scene",
+        "type": "string"
+      },
+      "say": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "scene_id": {
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      },
+      "seconds": {
+        "exclusiveMinimum": 0,
+        "maximum": 60,
+        "type": "number"
+      },
+      "see": {
+        "maxLength": 2000,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_scene",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "reorder",
+        "type": "string"
+      },
+      "scene_ids": {
+        "items": {
+          "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+        },
+        "maxItems": 40,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "scene_ids"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "energy": {
+        "enum": [
+          "upbeat",
+          "steady",
+          "calm"
+        ],
+        "type": "string"
+      },
+      "level": {
+        "enum": [
+          "quieter",
+          "louder"
+        ],
+        "type": "string"
+      },
+      "mood": {
+        "maxLength": 200,
+        "type": "string"
+      },
+      "off": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_music",
+        "type": "string"
+      },
+      "track_id": {
+        "maxLength": 120,
+        "type": "string"
+      },
+      "volume": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "on": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_captions",
+        "type": "string"
+      },
+      "style": {
+        "maxLength": 40,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "on"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_caption_tier",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "tier": {
+        "enum": [
+          "heading",
+          "body"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "tier"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "maximum": 3600,
+        "minimum": 0,
+        "type": "number"
+      },
+      "op": {
+        "const": "set_follow_stretch",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "to": {
+        "exclusiveMinimum": 0,
+        "maximum": 3600,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "note": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "redraw_storyboard",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "maxLength": 200,
+        "type": "string"
+      },
+      "op": {
+        "const": "set_voice",
+        "type": "string"
+      },
+      "source": {
+        "enum": [
+          "library",
+          "own",
+          "none"
+        ],
+        "type": "string"
+      },
+      "voice_name": {
+        "maxLength": 60,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "on": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_voiceover",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "on"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_style",
+        "type": "string"
+      },
+      "style": {
+        "enum": [
+          "bold",
+          "elegant",
+          "playful",
+          "minimal"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "style"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "hex": {
+        "items": {
+          "pattern": "^#[0-9a-fA-F]{6}$",
+          "type": "string"
+        },
+        "maxItems": 6,
+        "minItems": 1,
+        "type": "array"
+      },
+      "mode": {
+        "enum": [
+          "brand",
+          "designer",
+          "custom"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_colours",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "trim_to",
+        "type": "string"
+      },
+      "seconds": {
+        "exclusiveMinimum": 0,
+        "maximum": 600,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "seconds"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "asset_id": {
+        "maxLength": 80,
+        "type": "string"
+      },
+      "confirm": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_thing",
+        "type": "string"
+      },
+      "thing_id": {
+        "maxLength": 120,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "thing_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "enum": [
+          "remake",
+          "change_person",
+          "change_thing",
+          "bring_to_life",
+          "cutaway",
+          "longer",
+          "language",
+          "redraw"
+        ],
+        "type": "string"
+      },
+      "asset_ids": {
+        "items": {
+          "maxLength": 80,
+          "type": "string"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "language": {
+        "maxLength": 20,
+        "type": "string"
+      },
+      "note": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "add_scene_action",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "still_preview_id": {
+        "maxLength": 80,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "enum": [
+          "remake",
+          "change_person",
+          "change_thing",
+          "bring_to_life",
+          "cutaway",
+          "longer",
+          "language",
+          "redraw",
+          "opening",
+          "sharper"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_scene_action",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "pick_script_option",
+        "type": "string"
+      },
+      "option_id": {
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "option_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "asset_id": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "from": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "op": {
+        "const": "place_media",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "to": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "asset_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "as": {
+        "enum": [
+          "filmed",
+          "drawn"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "clear_media",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene_id": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "asset_id": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "op": {
+        "const": "insert_media_scene",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "after_scene_id",
+      "asset_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aspect": {
+        "enum": [
+          "9:16",
+          "4:5",
+          "1:1",
+          "16:9"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_format",
+        "type": "string"
+      },
+      "resolution": {
+        "enum": [
+          "720p",
+          "1080p"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "caption_placement": {
+        "enum": [
+          "top",
+          "bottom",
+          "auto"
+        ],
+        "type": "string"
+      },
+      "meme_caption": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "set_creative_direction",
+        "type": "string"
+      },
+      "presentation": {
+        "enum": [
+          "meme",
+          "standard",
+          "auto"
+        ],
+        "type": "string"
+      },
+      "visual_treatment": {
+        "enum": [
+          "realistic",
+          "animated",
+          "mixed",
+          "auto"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  }
+]
  5. Changed1 schema field changed
    • changedInput schema / properties / ops / items / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "fit": {
-        "enum": [
-          "frame",
-          "pan",
-          "split",
-          "crop"
-        ],
-        "type": "string"
-      },
-      "on_screen": {
-        "items": {
-          "maxLength": 200,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      },
-      "op": {
-        "const": "edit_scene",
-        "type": "string"
-      },
-      "say": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "scene_id": {
-        "maxLength": 40,
-        "minLength": 1,
-        "type": "string"
-      },
-      "seconds": {
-        "exclusiveMinimum": 0,
-        "maximum": 60,
-        "type": "number"
-      },
-      "see": {
-        "maxLength": 2000,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_scene",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "reorder",
-        "type": "string"
-      },
-      "scene_ids": {
-        "items": {
-          "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-        },
-        "maxItems": 40,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "op",
-      "scene_ids"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "energy": {
-        "enum": [
-          "upbeat",
-          "steady",
-          "calm"
-        ],
-        "type": "string"
-      },
-      "level": {
-        "enum": [
-          "quieter",
-          "louder"
-        ],
-        "type": "string"
-      },
-      "mood": {
-        "maxLength": 200,
-        "type": "string"
-      },
-      "off": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_music",
-        "type": "string"
-      },
-      "track_id": {
-        "maxLength": 120,
-        "type": "string"
-      },
-      "volume": {
-        "maximum": 1,
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "on": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_captions",
-        "type": "string"
-      },
-      "style": {
-        "maxLength": 40,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "on"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_caption_tier",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "tier": {
-        "enum": [
-          "heading",
-          "body"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "tier"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from": {
-        "maximum": 3600,
-        "minimum": 0,
-        "type": "number"
-      },
-      "op": {
-        "const": "set_follow_stretch",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "to": {
-        "exclusiveMinimum": 0,
-        "maximum": 3600,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "from",
-      "to"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "note": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "redraw_storyboard",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "id": {
-        "maxLength": 200,
-        "type": "string"
-      },
-      "op": {
-        "const": "set_voice",
-        "type": "string"
-      },
-      "source": {
-        "enum": [
-          "library",
-          "own",
-          "none"
-        ],
-        "type": "string"
-      },
-      "voice_name": {
-        "maxLength": 60,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "on": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_voiceover",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "on"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_style",
-        "type": "string"
-      },
-      "style": {
-        "enum": [
-          "bold",
-          "elegant",
-          "playful",
-          "minimal"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "style"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "hex": {
-        "items": {
-          "pattern": "^#[0-9a-fA-F]{6}$",
-          "type": "string"
-        },
-        "maxItems": 6,
-        "minItems": 1,
-        "type": "array"
-      },
-      "mode": {
-        "enum": [
-          "brand",
-          "designer",
-          "custom"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_colours",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "mode"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "trim_to",
-        "type": "string"
-      },
-      "seconds": {
-        "exclusiveMinimum": 0,
-        "maximum": 600,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "seconds"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "asset_id": {
-        "maxLength": 80,
-        "type": "string"
-      },
-      "confirm": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "set_thing",
-        "type": "string"
-      },
-      "thing_id": {
-        "maxLength": 120,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "thing_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "enum": [
-          "remake",
-          "change_person",
-          "change_thing",
-          "bring_to_life",
-          "cutaway",
-          "longer",
-          "language",
-          "redraw"
-        ],
-        "type": "string"
-      },
-      "asset_ids": {
-        "items": {
-          "maxLength": 80,
-          "type": "string"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "language": {
-        "maxLength": 20,
-        "type": "string"
-      },
-      "note": {
-        "maxLength": 400,
-        "type": "string"
-      },
-      "op": {
-        "const": "add_scene_action",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "still_preview_id": {
-        "maxLength": 80,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "action": {
-        "enum": [
-          "remake",
-          "change_person",
-          "change_thing",
-          "bring_to_life",
-          "cutaway",
-          "longer",
-          "language",
-          "redraw",
-          "opening",
-          "sharper"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "remove_scene_action",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "pick_script_option",
-        "type": "string"
-      },
-      "option_id": {
-        "maxLength": 40,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "option_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "asset_id": {
-        "format": "uuid",
-        "type": "string"
-      },
-      "from": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "op": {
-        "const": "place_media",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      },
-      "to": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id",
-      "asset_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "as": {
-        "enum": [
-          "filmed",
-          "drawn"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "clear_media",
-        "type": "string"
-      },
-      "scene_id": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-      }
-    },
-    "required": [
-      "op",
-      "scene_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene_id": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "asset_id": {
-        "format": "uuid",
-        "type": "string"
-      },
-      "op": {
-        "const": "insert_media_scene",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "after_scene_id",
-      "asset_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aspect": {
-        "enum": [
-          "9:16",
-          "4:5",
-          "1:1",
-          "16:9"
-        ],
-        "type": "string"
-      },
-      "op": {
-        "const": "set_format",
-        "type": "string"
-      },
-      "resolution": {
-        "enum": [
-          "720p",
-          "1080p"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "fit": {
+        "enum": [
+          "frame",
+          "pan",
+          "split",
+          "crop"
+        ],
+        "type": "string"
+      },
+      "on_screen": {
+        "items": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "type": "array"
+      },
+      "op": {
+        "const": "edit_scene",
+        "type": "string"
+      },
+      "say": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "scene_id": {
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      },
+      "seconds": {
+        "exclusiveMinimum": 0,
+        "maximum": 60,
+        "type": "number"
+      },
+      "see": {
+        "maxLength": 2000,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_scene",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "reorder",
+        "type": "string"
+      },
+      "scene_ids": {
+        "items": {
+          "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+        },
+        "maxItems": 40,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op",
+      "scene_ids"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "energy": {
+        "enum": [
+          "upbeat",
+          "steady",
+          "calm"
+        ],
+        "type": "string"
+      },
+      "level": {
+        "enum": [
+          "quieter",
+          "louder"
+        ],
+        "type": "string"
+      },
+      "mood": {
+        "maxLength": 200,
+        "type": "string"
+      },
+      "off": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_music",
+        "type": "string"
+      },
+      "track_id": {
+        "maxLength": 120,
+        "type": "string"
+      },
+      "volume": {
+        "maximum": 1,
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "on": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_captions",
+        "type": "string"
+      },
+      "style": {
+        "maxLength": 40,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "on"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_caption_tier",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "tier": {
+        "enum": [
+          "heading",
+          "body"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "tier"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from": {
+        "maximum": 3600,
+        "minimum": 0,
+        "type": "number"
+      },
+      "op": {
+        "const": "set_follow_stretch",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "to": {
+        "exclusiveMinimum": 0,
+        "maximum": 3600,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "from",
+      "to"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "note": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "redraw_storyboard",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "id": {
+        "maxLength": 200,
+        "type": "string"
+      },
+      "op": {
+        "const": "set_voice",
+        "type": "string"
+      },
+      "source": {
+        "enum": [
+          "library",
+          "own",
+          "none"
+        ],
+        "type": "string"
+      },
+      "voice_name": {
+        "maxLength": 60,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "on": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_voiceover",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "on"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_style",
+        "type": "string"
+      },
+      "style": {
+        "enum": [
+          "bold",
+          "elegant",
+          "playful",
+          "minimal"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "style"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "hex": {
+        "items": {
+          "pattern": "^#[0-9a-fA-F]{6}$",
+          "type": "string"
+        },
+        "maxItems": 6,
+        "minItems": 1,
+        "type": "array"
+      },
+      "mode": {
+        "enum": [
+          "brand",
+          "designer",
+          "custom"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_colours",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "mode"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "trim_to",
+        "type": "string"
+      },
+      "seconds": {
+        "exclusiveMinimum": 0,
+        "maximum": 600,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "seconds"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "asset_id": {
+        "maxLength": 80,
+        "type": "string"
+      },
+      "confirm": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "set_thing",
+        "type": "string"
+      },
+      "thing_id": {
+        "maxLength": 120,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "thing_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "enum": [
+          "remake",
+          "change_person",
+          "change_thing",
+          "bring_to_life",
+          "cutaway",
+          "longer",
+          "language",
+          "redraw"
+        ],
+        "type": "string"
+      },
+      "asset_ids": {
+        "items": {
+          "maxLength": 80,
+          "type": "string"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "language": {
+        "maxLength": 20,
+        "type": "string"
+      },
+      "note": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "add_scene_action",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "still_preview_id": {
+        "maxLength": 80,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "action": {
+        "enum": [
+          "remake",
+          "change_person",
+          "change_thing",
+          "bring_to_life",
+          "cutaway",
+          "longer",
+          "language",
+          "redraw",
+          "opening",
+          "sharper"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "remove_scene_action",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "pick_script_option",
+        "type": "string"
+      },
+      "option_id": {
+        "maxLength": 40,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "option_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "asset_id": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "from": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "op": {
+        "const": "place_media",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      },
+      "to": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id",
+      "asset_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "as": {
+        "enum": [
+          "filmed",
+          "drawn"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "clear_media",
+        "type": "string"
+      },
+      "scene_id": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+      }
+    },
+    "required": [
+      "op",
+      "scene_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene_id": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/scene_id"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "asset_id": {
+        "format": "uuid",
+        "type": "string"
+      },
+      "op": {
+        "const": "insert_media_scene",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "after_scene_id",
+      "asset_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aspect": {
+        "enum": [
+          "9:16",
+          "4:5",
+          "1:1",
+          "16:9"
+        ],
+        "type": "string"
+      },
+      "op": {
+        "const": "set_format",
+        "type": "string"
+      },
+      "resolution": {
+        "enum": [
+          "720p",
+          "1080p"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "caption_placement": {
+        "enum": [
+          "top",
+          "bottom",
+          "auto"
+        ],
+        "type": "string"
+      },
+      "meme_caption": {
+        "maxLength": 400,
+        "type": "string"
+      },
+      "op": {
+        "const": "set_creative_direction",
+        "type": "string"
+      },
+      "presentation": {
+        "enum": [
+          "meme",
+          "standard",
+          "auto"
+        ],
+        "type": "string"
+      },
+      "visual_treatment": {
+        "enum": [
+          "realistic",
+          "animated",
+          "mixed",
+          "auto"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  }
+]
  6. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true and non-idempotent, and the description layers on the operational facts those hints don't convey: edits are free, applied at once, undoable, nothing is created or charged, and a version mismatch applies nothing and returns the current storyboard to retry against. It also states which mutations are lossy (remove_scene, clear_media returning a scene to filmed/drawn) and which trigger re-renders (set_format redraws/reframes, set_follow_stretch re-makes the scene).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded correctly — the free/instant/undoable/no-charge traits come first, then the three top-level modes, then the op catalogue. But the op list is a single semicolon-and-parenthesis-chained block of roughly 450 words that is genuinely hard to scan, and some parenthetical asides (meme caption rules, fit explanations) are dense enough to be slowed by rather than used.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 21-op, 6-parameter mutation tool with no output schema, the description closes every loop an agent needs: concurrency via expected_version, rollback via undo/revert_turn, cost model, which ops re-render or charge, and exactly what a success returns (`changes` {id, summary}, new `version`, storyboard, button). Nothing essential to calling it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 67% and the description carries the load well, explaining op semantics the schema cannot: the ordering rule for `hex` ("most important first"), what `set_voice` source=none means for on-camera lines, how `say` on a filmed scene replaces the presenter's line rather than narrating, and that `set_follow_stretch` must match one of that scene's follow.choices. Gaps remain: the `fit` list in the description (frame|pan|split|crop) omits the schema's `backdrop`, and `still_preview_id` on add_scene_action is never explained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb+resource (change the film's storyboard) and immediately distinguishes it from siblings that spend money: make_studio_video spends, get_studio_video's `button` quotes the price. An agent knows instantly this is a free, in-place structural edit rather than a render or a script rewrite (edit_studio_video_script).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly enumerates the three mutually exclusive invocation modes (ops + expected_version, undo, revert_turn with keep) and says "Send ONE of". It also names the paid op (add_scene_action goes on the button), the free ops, and directs the agent to get_studio_video `button` for pricing — clear when-this vs when-that with no inference required.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Mondovo toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources