# Feedback

Feedback changes scenes of the storyboard, like a message in the mint chat. Each entry names a scene (`scene`), a time
(`at_s`) or both, and says what to change. mint plans and applies every entry on its own and never asks back.

1. Optionally request a [storyboard preview](/api/storyboard-previews) and refer to it with `preview_id`.
2. Send one or more entries with `POST /films/{id}/feedback`. Attach images with [uploads](/api/uploads).
3. Follow each entry: `queued` → `applying` → `applied`, or `failed` / `discarded`. Poll the entry or listen for
   `feedback.updated` events.
4. A failed entry can be sent again with `POST /films/{id}/feedback/{feedback_id}/retry`.

Feedback can cost credits according to the mint price list. Redrawing a scene at a fixed price only happens with
`allow_redraw: true`.

## Endpoints

- `POST /v1/films/{id}/feedback`: Send feedback on scenes of the storyboard
- `GET /v1/films/{id}/feedback/{feedback_id}`: Get a feedback entry
- `GET /v1/films/{id}/feedback`: List the feedback entries of a film
- `POST /v1/films/{id}/feedback/{feedback_id}/cancel`: Cancel a feedback entry
- `POST /v1/films/{id}/feedback/{feedback_id}/retry`: Retry a failed feedback entry