Story Films

List a product project's story films.

The ranked three with each pitch's reason and its full audit — every candidate's concept, register, judge verdict, score and written rank — plus modelUsed, generatedAt, updatedAt, and note when none have been pitched yet (right after a pitch an empty list, until the queued job lands). A read: it never pitches, decides or writes. Scope: story:read.

get/story-projects/{projectId}/story-films

Request

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

Response

The ranked story films and the audit that explains them.

projectIdstring required
candidatesobject[] required

Every candidate the round kept, with its concept, register and pitch, its judge verdict (the vetoes and rule hits), scored, and written rank — the audit that explains why the others are not in the three.

modelUsedstring nullable required

Who wrote the round (providers/model); null when none has run.

generatedAtstring nullable required

When the initial pitched round was generated; null when none has run.

updatedAtstring nullable required

When it changed as a whole; null when none is stored.

notestring nullable required

How many are stored (post-judge), or that none have been pitched yet.

Changes

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