Pitch three story films for a product (free).
PITCH three short films from the product's feature map, free and queued. A story film pitch is three short films about people, built from the project's feature map: each one names who is in it, what is at stake outside the product, and the one real recorded moment of the product the story turns on, the three come ranked with the reason for each, and any idea that was impossible for this product is said plainly, with why. A strict body { notes?, seconds? } (at most 2000 characters of the caller's own words — what matters, the audience, what to lead with — and how long the films run, 30 to 60 seconds, which the film the round writes by itself is written to; an unknown key is 400 validation_failed naming it). A story project is refused (a story film is built from shipped product features), and a product project not ready for one is 409 product_video_not_ready in the readiness step's own sentence, with details.next the verb that does it (a story film starts from the project's existing recordings, and with none its moments record in the app, so it waits on the app being connected and signed in to and on one shipped feature to build from) — nothing is queued. Answers 202 { projectId, queued, note } at once; GET this path until the ranked three land (minutes: the queued worker runs the pitch pass, then the judge). NOT metered and NOT confirmed. Requires Idempotency-Key. Scope: story:write.
Request
- Base URL: https://docs.sleeperhit.studio/api/v1
- URL: https://docs.sleeperhit.studio/api/v1/story-projects/{projectId}/story-films
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The pitch was replayed from its idempotency record (the same queued answer).
Changes
No recorded changes to this operation across all 2 revisions of this API.