Flyers

List the flyers of a cinema. Filterable by startDate/endDate so the editor can find the existing flyer for a programme period before creating one.

Create a flyer for the addressed cinema and programme period. flyerTemplateId is optional and, when given, must belong to the same cinema — omitted, the flyer is a standalone fork with no Flyer Template link. Several flyers may share one period — they are told apart by their name.

Get a single flyer. Cinema staff can only access flyers of their own cinema.

Delete a flyer and all of its versions (cascade). Cinema staff can only delete flyers of their own cinema.

Autosaves a flyer edit. version carries the optimistic-lock counter the client last read (docs/adr/0004): a mismatch against the stored value means someone else wrote in the meantime, and the API responds 409 without writing. A successful write increments the counter and appends the previous document to the flyer's versions (pruned to the newest 20).

Renders already-laid-out flyer markup to a PDF with the page, bleed and trim boxes a print shop needs. Cinema staff can only export flyers of their own cinema.