# The film progress object

## Attributes

- `object` (string, required):
- `film_id` (string, required): Id of the film.
- `status` (enum, required): Status of the film, as in GET /films/{id}. Values: `briefing`, `in_production`, `storyboard_ready`, `film_ready`, `approved`, `cancelled`.
- `stage` (nullable enum, required): Detailed stage, as in GET /films/{id}, or null if unknown. New values may be added within v1. Values: `briefing`, `style`, `voice`, `ready_to_plan`, `planning`, `storyboard_in_progress`, `storyboard_review`, `film_rendering`, `film_ready`, `approved`, `paused`, `error`, `cancelled`.
- `attention_required` (boolean, required): true if a person needs to act in mint, as in GET /films/{id}.
- `production` (nullable object, required): The latest production of the film, or null if there is none yet.
  - `status` (enum, required): queued, running, storyboard_ready (the storyboard is ready, no film is rendering), film_rendering, film_ready, failed or cancelled. New values may be added within v1. Values: `queued`, `running`, `storyboard_ready`, `film_rendering`, `film_ready`, `failed`, `cancelled`.
  - `phase` (enum, required): Current step (see steps[].id). Values: `audio`, `timeline`, `media`, `scenes`, `film`.
  - `storyboard_version` (nullable integer, required): Version of the storyboard this production works on.
  - `started_at` (nullable string (date-time), required): Start of the production (UTC).
  - `updated_at` (nullable string (date-time), required): Last change of the production (UTC).
- `steps` (array of objects, required): Steps of the production in order; empty without a production.
  - `id` (enum, required): audio, timeline, media, scenes or film. New values may be added within v1. Values: `audio`, `timeline`, `media`, `scenes`, `film`.
  - `status` (enum, required):  Values: `waiting`, `running`, `done`, `failed`.
  - `parts` (array of objects): Parts of the step with their own progress (only present if the step has parts).
    - `id` (string, required): Stable technical id of the part.
    - `label` (string, required): Display text of the part as shown in mint (German).
    - `status` (enum, required):  Values: `waiting`, `running`, `done`, `failed`.
    - `progress` (nullable number, required): Progress from 0 to 1, or null if unknown.
    - `started_at` (nullable string (date-time), required): Start of the part (UTC), or null.
- `scenes` (nullable object, required): Scene counts of the current storyboard, or null without a production.
  - `total` (integer, required): Scenes of the current storyboard (sum of the other counts).
  - `done` (integer, required): Finished in the current state.
  - `rendering` (integer, required): Being created or changed right now.
  - `pending` (integer, required): Not started yet.
  - `outdated` (integer, required): Finished, but in an older state of the storyboard.
  - `failed` (integer, required): The last change of the scene failed.
- `estimate` (nullable object, required): Rough estimate of the remaining time, or null.
  - `remaining_s` (integer, required): Estimated remaining seconds.
  - `confidence` (enum, required): low or medium. Treat it as a rough guess. Values: `low`, `medium`.
  - `basis` (enum, required): scene_rate: from the scenes finished so far; film_render: from the progress of the film render. New values may be added within v1. Values: `scene_rate`, `film_render`.

## Example

```json
{
  "object": "film_progress",
  "film_id": "k7m2xq9v4t8n1b5r3c6d0wza",
  "status": "in_production",
  "stage": "storyboard_in_progress",
  "attention_required": false,
  "production": {
    "status": "running",
    "phase": "scenes",
    "storyboard_version": 1,
    "started_at": "2026-11-10T08:00:04Z",
    "updated_at": "2026-11-10T08:14:52Z"
  },
  "steps": [
    {
      "id": "scenes",
      "status": "running",
      "parts": [
        {
          "id": "scene-07",
          "label": "Scene 7",
          "status": "running",
          "progress": 0.6,
          "started_at": "2026-11-10T08:13:30Z"
        }
      ]
    }
  ],
  "scenes": {
    "total": 14,
    "done": 9,
    "rendering": 2,
    "pending": 3,
    "outdated": 0,
    "failed": 0
  },
  "estimate": {
    "remaining_s": 240,
    "confidence": "medium",
    "basis": "scene_rate"
  }
}
```