---
title: "undo_storyboard: Undo on a storyboard"
description: "Take back YOUR last gesture on a film, or redo the one you took back."
canonical_url: "https://meetkuro.com/agents/tools/undo_storyboard/"
updated: 2026-11-03
locale: "en"
tool: "undo_storyboard"
scopes: ["storyboards.write"]
---

# undo_storyboard

**Undo on a storyboard**

Take back YOUR last gesture on a film, or redo the one you took back. Contiguous writes from a tool call form one step. If another author edits between its writes, that call has multiple steps; this reverses only the latest one. The board's own history is shared with the person: their ⌘Z walks the same stack. If the person (or the Studio assistant) has changed the board since your last gesture, it refuses rather than undoing their work — set include_others only when the user asked you to take their change back. A retry of the same call does not undo twice.

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

## Inputs

| Name | Type | Required | Details |
| --- | --- | --- | --- |
| `storyboard_id` | string | yes | uuid |
| `redo` | boolean | no | — |
| `include_others` | boolean | no | Also take back a step the person or the Studio assistant made. Only when the user asked for that. |

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

## Input schema

As the server sends it in `tools/list`:

```json
{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "redo": {
      "type": "boolean"
    },
    "include_others": {
      "type": "boolean",
      "description": "Also take back a step the person or the Studio assistant made. Only when the user asked for that."
    }
  },
  "required": [
    "storyboard_id"
  ],
  "additionalProperties": false
}
```

## Related tools

- [`add_scene`](https://meetkuro.com/agents/tools/add_scene.md): Add one scene to a film.
- [`update_scene`](https://meetkuro.com/agents/tools/update_scene.md): Change one scene by its 1-based number: title, description, image or motion prompt, length (or auto_duration where the clip model offers it), hold_motion, cast by Subject name, or its own clip model (null hands it back to the film's).
- [`move_scene`](https://meetkuro.com/agents/tools/move_scene.md): Move one scene to sit right after another (after_scene 0 puts it first).
- [`delete_scene`](https://meetkuro.com/agents/tools/delete_scene.md): Delete one scene by number.
- [`set_scene_image`](https://meetkuro.com/agents/tools/set_scene_image.md): Use an image the account already holds — a generation or an upload — as one scene's still, replacing the one it has.
- [`set_scene_clip`](https://meetkuro.com/agents/tools/set_scene_clip.md): Attach existing footage to one scene: an owned ready clip generation, a verified video upload, or a finished storyboard render.
- [`connect_scenes`](https://meetkuro.com/agents/tools/connect_scenes.md): Draw an arrow from one scene to another, by number — a branch or a convergence makes a second video path through the board.
- [`disconnect_scenes`](https://meetkuro.com/agents/tools/disconnect_scenes.md): Remove the arrow from one scene to another, by number.

---

## 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/