---
title: "Get AI edit run"
method: GET
path: "/ai-edit/runs/{runId}"
tags: ["Platform"]
---

# Get AI edit run

`GET /ai-edit/runs/{runId}`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/ai-edit/runs/{runId}`
- Auth: API key in header `Authorization`

Get AI edit run.

## Path parameters

- `runId` string, required

## Response `200`

Successful response

- object
  - `run` object, required
    - `id` string, required
    - `project_id` string, required
    - `organization_id` string, required
    - `user_id` string, required
    - `api_key_id` string, nullable, required
    - `execution_mode` 'external_controller' | 'hosted_agent', required
    - `credit_mode` 'external' | 'platform_credits' | 'byok', required
    - `controller_kind` 'api' | 'cli' | 'codex' | 'claude_code' | 'platform' | 'unknown', required
    - `status` 'queued' | 'understanding' | 'planning' | 'applying' | 'rendering' | 'critiquing' | 'repairing' | 'completed' | 'failed' | 'needs_review', required
    - `style_id` 'mirage-black' | 'clean-founder' | 'formation-clipperz', required
    - `quality_target` 'fast' | 'premium' | 'frontier', required
    - `run_config` object, required
    - `budget_receipt` object, required
    - `summary` string, nullable, required
    - `failure_message` string, nullable, required
    - `completed_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
  - `context` object, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)