---
title: "Create external AI edit run"
method: POST
path: "/projects/{projectId}/ai-edit/runs"
tags: ["Platform"]
---

# Create external AI edit run

`POST /projects/{projectId}/ai-edit/runs`

## Request

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

Create external AI edit run.

## Path parameters

- `projectId` string, required

## Request body

- object
  - `style_id` 'mirage-black' | 'clean-founder' | 'formation-clipperz', required
  - `quality_target` 'fast' | 'premium' | 'frontier'
  - `controller_kind` 'api' | 'cli' | 'codex' | 'claude_code' | 'platform' | 'unknown'
  - `dry_run` boolean

## 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
- `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)