DOdovetail
Transcripts

Attach audio

Changed on

Attach an already-uploaded audio file to the live transcript on a data entry. The transcript node currently being written to via appendLiveTranscriptUtterance or setLiveTranscript is wrapped in an audio/video block carrying the supplied file_id, giving the editor audio playback + transcript-sync.

Idempotent for the same file_id (returns 200). Returns 409 if the transcript is already wrapped with a different file_id. Returns 404 if the data entry does not exist.

Required scope: note:write

post/v1/transcripts/{data_id}/audio

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/transcripts/{data_id}/audio
  • Auth
    HTTP bearer

Path parameters

data_idstring required

Unique identifier of the data entry.

Request body

file_idstring required

ID of an already-uploaded audio file to attach.

Response

200

dataobject required

Changes

  • 8abea327e6b9Revision changes
    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status