---
title: "rewind_workflow_run: Rewind workflow run"
description: "Re-run a workflow run from an earlier step, using its current revision from get_workflow_run."
canonical_url: "https://meetkuro.com/agents/tools/rewind_workflow_run/"
updated: 2026-11-03
locale: "en"
tool: "rewind_workflow_run"
scopes: ["generation.write"]
---

# rewind_workflow_run

**Rewind workflow run**

Re-run a workflow run from an earlier step, using its current revision from get_workflow_run. Everything before that step is kept; everything from it on is set aside and run again. Allowed from any status, a finished run included — the steps you may name are `recovery.rewind_step_ids`. quote=true prices the rewind and changes nothing.

## Scope

- `generation.write` — Makes, edits, imports, shares and deletes media in the account.

## 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 |
| --- | --- | --- | --- |
| `run_id` | string | yes | uuid |
| `step_id` | string | yes | matches ^[a-z][a-z0-9_]*$ |
| `revision` | integer | yes | ≥ 0 |
| `quote` | boolean | no | — |

## 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": "rewind_workflow_run",
    "arguments": {
      "run_id": "00000000-0000-4000-8000-000000000000",
      "step_id": "<step_id>",
      "revision": 0
    }
  }
}
```

## Input schema

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

```json
{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "format": "uuid"
    },
    "step_id": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9_]*$"
    },
    "revision": {
      "type": "integer",
      "minimum": 0
    },
    "quote": {
      "type": "boolean"
    }
  },
  "required": [
    "run_id",
    "step_id",
    "revision"
  ],
  "additionalProperties": false
}
```

## Related tools

- [`get_workflow_run`](https://meetkuro.com/agents/tools/get_workflow_run.md): Read a workflow run, its recorded steps, generations, and current checkpoint.

---

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