Put the chapters in a new order.
Puts the deck's chapters in a new order: order names every chapter's chapterIndex once, in the order they will play, or move puts one chapter just after another (afterChapterIndex) or first (afterChapterIndex: null). Free: nothing renders and every chapter keeps its takes; a rendered deck's video is stitched again in the new order. Chapters filmed in one render (a scene group: a chapter whose renderedWith names another, and that chapter) move as one block, side by side in their order; an order that pulls them apart is refused (pitch_deck_scene_group_split) and a move of one of them moves the whole group. The chapters are renumbered from 0 in their new order (each answer chapter's previousChapterIndex is its key before). How a chapter hands into the next and the black after it travel with it (a black whose chapter now ends the deck is taken out and named in droppedInterludes); music and sound laid on one chapter move with it, and a score composed to the old order keeps playing but no longer lands on the chapters (score: no_longer_fits) until it is scored again, priced. A draft plan, review or complete; on a draft the changed plan is queued for plan coverage again (planCoverage). A rendered deck waits while its video is being put together or its automatic fixes are running (409 pitch_deck_reorder_assembly_running, pitch_deck_reorder_auto_fix_running). A scene group pulled apart is refused with 409 pitch_deck_state_invalid (details.refusal.code: pitch_deck_scene_group_split), as is a rendered deck whose video is being put together (pitch_deck_reorder_assembly_running) or whose automatic fixes are reviewing or fixing it (pitch_deck_reorder_auto_fix_running); nothing changes. An order that does not name every chapter once is a 400. 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/pitch-decks/{jobId}/chapters/reorder
- Auth: HTTP bearer
Headers
Customer-generated stable identifier for safe retries of idempotent POST requests.
Request body
Response
The chapters in their new order, and what the move did to the cut.
Changes
No recorded changes to this operation across all 2 revisions of this API.