update_storyboard

Update a film

Change a film's own properties in one call; only the fields you send change. name; description (null clears it); user_tags (replaces the account's own tags, never the Organizer's); favorite; cover_scene (that scene's still becomes the cover); cast (replaces it with the Subjects named, which list_subjects finds; empty casts nobody); settings (aspect ratio, default image and clip models, clip resolution and audio, style by id or name, null takes the film off a style — scenes whose takes no longer fit are re-fitted and listed); archived (reversible, the first answer to a film the user no longer wants; delete_storyboard is the permanent one). One undo step; undo_storyboard takes it back. Spends no credits.

Scope

storyboards.write — Authors, edits, renders and deletes storyboards. Reading a board rides media.read, and the two board tools that spend need generation.write as well.

Behaviour

Writes: Creates or changes items in the caller's own account.
Can delete or overwrite: Can delete, overwrite, cancel or withdraw something the caller already has, so a host should confirm it.
Stays in the account: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.

Credits

What the tool's description says about credits, verbatim.

Spends no credits.

Inputs

storyboard_idstring · required
uuid
namestring · optional
at least 1 character · at most 100 characters
descriptionstring or null · optional
user_tagsarray of string · optional
at most 8 items
favoriteboolean · optional
cover_sceneinteger · optional
> 0
castarray of string · optional
settingsobject · optional
fields: aspect_ratio, default_image_model, default_video_model, clip_resolution, clip_audio, style
archivedboolean · optional

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_storyboard",
    "arguments": {
      "storyboard_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300
        },
        {
          "type": "null"
        }
      ]
    },
    "user_tags": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 40
      },
      "maxItems": 8
    },
    "favorite": {
      "type": "boolean"
    },
    "cover_scene": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "cast": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "settings": {
      "type": "object",
      "properties": {
        "aspect_ratio": {
          "type": "string",
          "enum": [
            "9:16",
            "1:1",
            "16:9"
          ]
        },
        "default_image_model": {
          "type": "string",
          "enum": [
            "seedream-5-lite",
            "nano-banana-2.1",
            "nano-banana-2",
            "gpt-image-2.5-flare",
            "gpt-image-2.5-sunburst",
            "gpt-image-2",
            "nano-banana-2-lite",
            "seedream-5-pro",
            "flux-schnell",
            "flux-2-flex",
            "flux-2-pro",
            "flux-2-max",
            "recraft-v4.1-svg",
            "recraft-v4.1-pro-svg",
            "p-image",
            "grok-imagine-image",
            "grok-imagine-image-quality",
            "krea-3",
            "qwen-image-3-pro",
            "soul-2"
          ]
        },
        "default_video_model": {
          "type": "string",
          "enum": [
            "seedance-2.5",
            "seedance-2.0",
            "seedance-2.0-mini",
            "seedance-2.0-fast",
            "grok-imagine-video-1.5",
            "veo-3.1",
            "veo-3.1-fast",
            "veo-3.1-lite",
            "gemini-omni-1.1",
            "kling-v3-omni-video",
            "kling-v3-video",
            "happyhorse-1.0",
            "wan-3",
            "wan-3-prime",
            "gen-4.5",
            "p-video",
            "p-video-2",
            "flux-3",
            "minimax-h3-max",
            "p-video-avatar",
            "p-video-animate",
            "p-video-replace",
            "omni-human-1.5",
            "kling-avatar-v2",
            "kling-v3-motion-control",
            "kling-lip-sync",
            "sync-lipsync-2",
            "genjutsu-motion-transfer",
            "genjutsu-object-swap"
          ]
        },
        "clip_resolution": {
          "type": "string",
          "enum": [
            "360p",
            "480p",
            "720p",
            "768p",
            "1080p",
            "4K"
          ]
        },
        "clip_audio": {
          "type": "boolean"
        },
        "style": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "archived": {
      "type": "boolean"
    }
  },
  "required": [
    "storyboard_id"
  ],
  "additionalProperties": false
}

Related tools

list_subjects
The named identities this account reuses — a character, a location, a product, a prop, a wardrobe.
delete_storyboard
Delete a film for good — the board, its scenes, its history — and stop anything it is still rendering or filming.
undo_storyboard
Take back YOUR last gesture on a film, or redo the one you took back.
create_storyboard
Make a film three ways: from a brief you have written as scenes, from media the account already holds, or from a video you have already analysed.

Every tool· This page as Markdown