---
title: "get_workflow_run: Get workflow run"
description: "Read a workflow run, its recorded steps, generations, and current checkpoint."
canonical_url: "https://meetkuro.com/agents/tools/get_workflow_run/"
updated: 2026-11-03
locale: "en"
tool: "get_workflow_run"
scopes: ["media.read"]
---

# get_workflow_run

**Get workflow run**

Read a workflow run, its recorded steps, generations, and current checkpoint. A run whose score builds a film reports it as storyboard: its id, name, scene count and app_url — read the board itself with get_storyboard.

## Scope

- `media.read` — Reads the account: media, uploads, boards, runs, Subjects, models and the balance.

## Behaviour

- **Read-only**: Reads the caller's own account and changes nothing.
- **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.
- **Idempotent**: Calling it again with the same arguments has no further effect.

## Inputs

| Name | Type | Required | Details |
| --- | --- | --- | --- |
| `run_id` | string | yes | uuid |

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

## Input schema

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

```json
{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "run_id"
  ],
  "additionalProperties": false
}
```

## Related tools

- [`get_storyboard`](https://meetkuro.com/agents/tools/get_storyboard.md): Read a film: its settings, its cast, every scene by number with its prompts and the state of its still and its clip, each derived video with how many clips it has and whether it can render, the computed still order, and the history depth.
- [`list_workflow_runs`](https://meetkuro.com/agents/tools/list_workflow_runs.md): Page through your workflow runs, newest first — every run of every recipe, or those of one recipe you own with `recipe_id`.
- [`resume_workflow_run`](https://meetkuro.com/agents/tools/resume_workflow_run.md): Resume the current pause or checkpoint using its revision from get_workflow_run a workflow run.
- [`retry_workflow_run`](https://meetkuro.com/agents/tools/retry_workflow_run.md): Pick a failed or canceled run up where it stopped, using its current revision from get_workflow_run.
- [`rewind_workflow_run`](https://meetkuro.com/agents/tools/rewind_workflow_run.md): Re-run a workflow run from an earlier step, using its current revision from get_workflow_run.
- [`decide_workflow_items`](https://meetkuro.com/agents/tools/decide_workflow_items.md): Answer an engine run paused on `items`: for every failed item the run is waiting on, retry it, edit its prompt and retry, or skip it.

---

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