Pitch Deck

Cast the narrator for this deck.

Casts the voice that narrates THIS deck, or send voiceId: null to drop back to the default (the cast canon's NARRATOR, else the table read's, else the default narrator). A deck's narrator speaks every line the narrator carries (chapter narration and lines over black). It resolves in one order: the voice cast for THIS deck (set_pitch_deck_narrator), else the cast canon's NARRATOR, else the table read's NARRATOR, else the default narrator. Casting or clearing it is free; on a rendered deck the narrated lines are voiced again in the new voice and the master is re-assembled, at no charge. Allowed while the deck is a draft plan, in review or complete (409 otherwise). Answers the resolved narrator and reassembling. Requires Idempotency-Key. Scope: story:write.

post/pitch-decks/{jobId}/narrator

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/pitch-decks/{jobId}/narrator
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Customer-generated stable identifier for safe retries of idempotent POST requests.

Request body

voiceIdstring nullable required

Studio voice id, or null to drop back to the default narrator.

provider'cartesia' | 'elevenlabs' | 'openai' | 'deepgram' | 'hume' | 'null' nullable

The voice's TTS provider. Inferred when omitted.

Response

The deck's resolved narrator.

reassemblingboolean required

True when a rendered deck's narration is voiced again and its master re-assembled (free).

Changes

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