Storyboard
Create a film/video storyboard with scenes and frames for visualizing stories, movie sequences, commercials, and video content.
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
scenesobject[]requiredArray containing one scene with frames
Child attributes
idstringrequiredScene ID (e.g., "scene_default")
titlestringrequiredScene title
isDefaultbooleantrue for main scene
colorstringScene color (e.g., "#e94560")
framesobject[]requiredArray of frame objects
settingsobjectrequiredStoryboard settings
Child attributes
boardTitlestringStoryboard title
themeenum<string>One of light or dark. Defaults to light.
showMetadatabooleanDefaults to true.
frameSizeenum<string>One of small, medium or large. Defaults to medium.
storyboardSettingsobjectExample
{
"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": [
{}
]
}
}
}
}
Add one record
POST /boards/{boardId}/items/{itemId}/records adds one of these to an item already on a board and leaves the rest of it as it is. Send the same key again to update that record instead of adding another.
Record fields
titlestringrequireddescriptionstringscenestringThe scene it goes in; made when the storyboard has none by that name.
keystringYour own id for this record, like an issue key. Sending the same key again updates and moves that record instead of adding another.
{
"record": {
"title": "Q4 Launch Planning",
"description": "string",
"scene": "string",
"key": "string"
}
}