Shows

Fix one line of a show episode.

Fix one line of a made episode (published, held or a preview) exactly, without a rewrite: find is the text as it stands in the script and replaceWith what it becomes. Only that text changes: text not in the script, or in it more than once, is refused with the lines that come closest (lines). Two calls: without userConfirmed it returns the price and the line before and after, changing nothing; with it, the line is re-voiced, and once it is the episode is mixed again by itself (its sounds and theme on the new line), and a published episode's feed audio is replaced. The re-voice costs the same as revising a table read (TABLE_READ_REFINE); the re-mix after it is free. Requires Idempotency-Key.

post/publishing-series/{seriesId}/show/episodes/{episodeId}/fix-line

Request

  • Base URL: https://docs.sleeperhit.studio/api/v1
  • URL: https://docs.sleeperhit.studio/api/v1/publishing-series/{seriesId}/show/episodes/{episodeId}/fix-line
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

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

Request body

findstring required

The text to change, exactly as it stands in the episode's script (part of one line is enough when it names one place).

replaceWithstring required

What that text becomes.

userConfirmedboolean

Omit to get the price and the line before and after, changing nothing. true re-voices the line, after the user agrees.

Response

Quoted, queued, or the text is not in the script exactly once.

status'quoted' | 'queued' | 'not_found' | 'ambiguous' required

quoted: the price, nothing changed. queued: the line is being re-voiced, then the episode is re-mixed by itself. not_found / ambiguous: the text is not in the script exactly once; lines are the closest.

quotedOnlytrue
episodeIdstring required
beforestring

The script line as it stands.

afterstring

The script line as it would read.

creditsinteger
balanceAfterinteger
sufficientboolean
storyJobIdstring

Queued only: the re-voice job.

linesstring[]

Refused only: the script lines that come closest, or that hold the text.

notestring required

Changes

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