---
title: "Poll a blueprint run"
method: GET
path: "/v1/blueprints/runs/{id}"
---

# Poll a blueprint run

`GET /v1/blueprints/runs/{id}`

## Request

- Base URL: `https://api.ffmpeg-micro.com`
- URL: `https://api.ffmpeg-micro.com/v1/blueprints/runs/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

Run status and, when completed, a signed output URL (10 min TTL)

- object
  - `id` string, uuid
  - `blueprint` string
  - `status` 'pending' | 'processing' | 'awaiting_review' | 'completed' | 'failed'
  - `step` string, nullable
  - `output_url` string, nullable
  - `error_message` string, nullable
  - `tokens_spent` integer
  - `srt_text` string: Present only while an Auto Captions run awaits transcript review
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable

## Other responses

- `401`: Missing/invalid API key
- `404`: Run not found (or belongs to another user)

---

[API](https://skmtc.dev/ffmpeg-micro/apis/ffmpeg-micro-api.md) · [All operations](https://skmtc.dev/ffmpeg-micro/apis/ffmpeg-micro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ffmpeg-micro/apis/ffmpeg-micro-api/revisions/64bb930ff345?raw)