# Storyboard

> Create a film/video storyboard with scenes and frames for visualizing stories, movie sequences, commercials, and video content.

Source: https://mockflow.com/developers/reference/item-types/storyboard

Send `"type": "storyboard"`.

Create a film/video storyboard with scenes and frames for visualizing stories, movie sequences, commercials, and video content.

Also available as the MCP tool `render_storyboard`. The same payload works through either surface.

### Fields

- `scenes` (object[], required): Array containing one scene with frames
    - `id` (string, required): Scene ID (e.g., "scene_default")
  - `title` (string, required): Scene title
  - `isDefault` (boolean): true for main scene
  - `color` (string): Scene color (e.g., "#e94560")
  - `frames` (object[], required): Array of frame objects
- `settings` (object, required): Storyboard settings
    - `boardTitle` (string): Storyboard title
  - `theme` (enum<string>): One of `light` or `dark`. Defaults to `light`.
  - `showMetadata` (boolean): Defaults to `true`.
  - `frameSize` (enum<string>): One of `small`, `medium` or `large`. Defaults to `medium`.
  - `storyboardSettings` (object)

## Example

```json
{
  "type": "storyboard",
  "data": {
    "scenes": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "isDefault": false,
        "color": "string",
        "frames": [
          {
            "id": "string",
            "sequence": 0,
            "title": "Q4 Launch Planning",
            "description": "string",
            "coverType": "string",
            "coverFileID": "string",
            "metadata": {
              "field1": "string",
              "field2": "string",
              "field3": "string",
              "field4": "string"
            },
            "comments": [
              {}
            ],
            "createdAt": "string"
          }
        ]
      }
    ],
    "settings": {
      "boardTitle": "Q4 Launch Planning",
      "theme": "light",
      "showMetadata": true,
      "frameSize": "medium",
      "storyboardSettings": {
        "customFields": [
          {}
        ],
        "frameNumber": {
          "format": "number",
          "prefix": "",
          "startFrom": 1
        },
        "brandGuide": {
          "primaryColor": "#1c7ce2",
          "secondaryColor": "#6c757d",
          "accentColor": "#e94560",
          "bgColor": "#ffffff",
          "artStyle": "string",
          "styleNotes": "string"
        },
        "features": {
          "enableCharacters": true,
          "enableScenes": true
        },
        "characters": [
          {}
        ],
        "customScenes": [
          {}
        ]
      }
    }
  }
}
```