add_storyboard_text

Add text to a film

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.

Adds or updates

Adds or updates; nothing the caller already has is deleted or overwritten.

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

• textstring · required

  at least 1 character · at most 500 characters

• sizestring · optional

  one of "title", "body"

• near_sceneinteger · optional

  > 0

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": "add_storyboard_text",
    "arguments": {
      "storyboard_id": "00000000-0000-4000-8000-000000000000",
      "text": "<text>"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "size": {
      "type": "string",
      "enum": [
        "title",
        "body"
      ]
    },
    "near_scene": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "storyboard_id",
    "text"
  ],
  "additionalProperties": false
}

Related tools

• update_storyboard_annotation

  Change one note or text element on a film's canvas, by the [id] the brief prints (note_… or text_…): its words, a note's color, or a text's size.

• remove_storyboard_annotation

  Take one note or text element off a film's canvas, by the [id] the brief prints (note_… or text_…).

• undo_storyboard

  Take back YOUR last gesture on a film, or redo the one you took back.

Every tool· This page as Markdown