Trailer

List a project's trailers.

Lists the project's season- and project-scoped trailer jobs, newest first: each trailer's id, title, status, createdAt / updatedAt, targetSeconds, motionTheme, beatCount, published, the last render's renderedVideoStatus / renderedVideoUrl and any errorMessage. ?season=N narrows it to one season; ?episode=<episodeId> (an episode id from GET /story-projects/{projectId}/seasons) lists one episode's videos instead: a story episode's trailers through its script, or the project videos made of a product feature (bibleEpisodeId). Other episode trailers are keyed on their script's upload and are not listed here, and a project the caller cannot open lists nothing. The same read MCP list_trailers makes. Read-only; costs no credits. Scope: story:read.

get/story-projects/{projectId}/trailers

Request

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

Query parameters

seasoninteger

Only this season's project trailers.

episodestring

Only this episode's videos (an episode id from the project's seasons). Not with season; 400 for an id the Bible does not have.

Response

The project's trailers, newest first.

idstring required
titlestring required
statusstring required

The trailer's workflow status (draft / rendering / review / finishing / complete / failed).

createdAtstring date-time
updatedAtstring date-time
targetSecondsnumber nullable
motionThemestring nullable
beatCountinteger nullable
renderedVideoStatusstring nullable
renderedVideoUrlstring nullable
publishedboolean
errorMessagestring nullable

Changes

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