Story Films

Choose how we see a story film's screen.

How we see the screen is set for each product moment, by Slug unless the writer picks; the first time a film shows the screen it is always over the shoulder, and only later moments may cut straight to it: full screen cuts straight to the real recording filling the frame, with a slow push in; over the shoulder opens behind the person at the laptop with the real recording on its screen (at most 6 s), then pushes into full screen; hands, then full screen (a preview) leads in with one short shot of the person's hands, never the screen. An over-the-shoulder shot that cannot be placed opens the moment on the hands instead, never on the flat screen; a shot that renders unusable is left out by itself. The next cut planned from the script uses it; a cut already planned keeps how it was planned. { kind } sets every moment's view (full-screen, over-the-shoulder or hands-then-full-screen); { momentId, kind } sets one moment's, and kind: null hands it back to Slug's choice. setBy is writer (the default) or slug; reason is one optional line. screen-in-room and over-the-shoulder-on-phone are not offered yet (400 validation_failed). Free. Scope: story:write.

put/story-projects/{projectId}/story-films/{storyId}/screen-view

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/story-films/{storyId}/screen-view
  • Auth: HTTP bearer

Request body

kind'full-screen' | 'hands-then-full-screen' | 'over-the-shoulder' | 'null' nullable required
momentIdstring

One product moment of the film. Omitted: every moment.

setBy'slug' | 'writer'

writer (the default) for the writer's own pick; slug when Slug applies its own taste.

reasonstring

Why, in one line.

Response

Every moment's view, who chose it and why, and a note.

projectIdstring required
storyIdstring required
notestring required

What changed and when it applies, to read out.

Changes

No recorded changes to this operation across all 2 revisions of this API.