# Films

A film is ordered from a briefing: a title, the narration text and the mint user who is responsible for it. mint plans
and produces it automatically up to the storyboard (`automation: "storyboard"`) or up to the film (`"film"`). People
review and approve the film in mint; the API never approves a film.

**Status.** `briefing` → `in_production` → `storyboard_ready` → `film_ready` → `approved`, or `cancelled`. `stage`
shows the detailed stage as in the mint project list, `attention_required` and `notice` tell you when a person
needs to act in mint.

Only films ordered through the API are visible to the API. Credits are always taken from your company.

## Endpoints

- `POST /v1/films`: Create a film from a briefing
- `GET /v1/films/{id}`: Get a film
- `GET /v1/films`: List films
- `POST /v1/films/{id}/cancel`: Cancel a film
- `GET /v1/films/{id}/file`: Download the approved film file
- `GET /v1/films/{id}/subtitles.srt`: Download the subtitles of the approval