update_storyboard_annotation

Update a note or text

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

• idstring · required

  A note's or text's [id], as the brief prints it.

  matches ^(note|text)_[a-z0-9_/-]+$

• textstring · optional

  at most 500 characters

• colorstring · optional

  Notes only.

  one of "yellow", "pink", "blue", "green"

• sizestring · optional

  Text elements only.

  one of "title", "body"

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

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "id": {
      "type": "string",
      "pattern": "^(note|text)_[a-z0-9_/-]+$",
      "description": "A note's or text's [id], as the brief prints it."
    },
    "text": {
      "type": "string",
      "maxLength": 500
    },
    "color": {
      "type": "string",
      "enum": [
        "yellow",
        "pink",
        "blue",
        "green"
      ],
      "description": "Notes only."
    },
    "size": {
      "type": "string",
      "enum": [
        "title",
        "body"
      ],
      "description": "Text elements only."
    }
  },
  "required": [
    "storyboard_id",
    "id"
  ],
  "additionalProperties": false
}

Related tools

• undo_storyboard

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

• add_storyboard_note

  Put a sticky note on a film's canvas, optionally near a scene and in a color.

• add_storyboard_text

  Put a text element on a film's canvas — a title or body text — optionally near a scene.

Every tool· This page as Markdown