Update Transcript

Replaces the transcript of a media file with the array you send. Read the transcript first with GET /media/transcript/{mediaId}, change what you need, and send the whole array back.

Avoid overwriting someone else's save

Send expectedTranscriptRevision with the transcriptRevision you read. If anyone saved the transcript since, the request returns 409 "This transcript changed since you opened it. Reload to keep editing." and changes nothing: read the transcript again, reapply your change, and save with the new revision. Leave it out and the save always goes through, replacing whatever is there.

A successful save increases the revision by one and returns the new value. Labels and comments on passages are then moved to follow their words in the background.

Request rules

• transcript needs at least one sentence; an empty transcript cannot be saved.
• Sentence id values must be unique when you send expectedTranscriptRevision.
• Keys that are not listed below return 400.

Errors

• 400 when the body fails validation.
• 404 when your company has no media with that id.
• 409 when expectedTranscriptRevision is stale.