---
title: "update_storyboard_annotation: Update a note or text"
description: "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."
canonical_url: "https://meetkuro.com/agents/tools/update_storyboard_annotation/"
updated: 2026-11-03
locale: "en"
tool: "update_storyboard_annotation"
scopes: ["storyboards.write"]
---

# update_storyboard_annotation

**Update a note or text**

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. 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

| Name | Type | Required | Details |
| --- | --- | --- | --- |
| `storyboard_id` | string | yes | uuid |
| `id` | string | yes | A note's or text's [id], as the brief prints it. — matches ^(note\|text)_[a-z0-9_/-]+$ |
| `text` | string | no | at most 500 characters |
| `color` | string | no | Notes only. — one of "yellow", "pink", "blue", "green" |
| `size` | string | no | 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.

```json
{
  "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`:

```json
{
  "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`](https://meetkuro.com/agents/tools/undo_storyboard.md): Take back YOUR last gesture on a film, or redo the one you took back.
- [`add_storyboard_note`](https://meetkuro.com/agents/tools/add_storyboard_note.md): Put a sticky note on a film's canvas, optionally near a scene and in a color.
- [`add_storyboard_text`](https://meetkuro.com/agents/tools/add_storyboard_text.md): Put a text element on a film's canvas — a title or body text — optionally near a scene.

---

## About Kuro

Kuro is an AI picture studio: prompt-driven images, clips, voice-overs and music, and storyboard-backed films with consistent characters across every scene.

Agents connect over MCP and can generate directly:

```
claude mcp add kuro https://api.meetkuro.com/mcp --transport http
```

The app is at https://app.meetkuro.com and requires an account.

Each guide, model page, comparison and free tool page on this site (not a tool's variants, and not the index pages) has a Markdown twin at its own URL plus `.md`, and so do /benchmarks/, the English /agents/ page (as /agents.md) and the MCP tool reference. Every tool: https://meetkuro.com/agents/tools/