DOdovetail
Transcripts

Add utterance

Changed on

Add a finalised utterance to a data entry's transcript and broadcast it to connected clients. If the entry has no transcript, one is created automatically. Send finalised utterances only.

Required scope: note:write

post/v1/transcripts/{data_id}/utterance

Request

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

Path parameters

data_idstring required

Unique identifier of the data entry.

Request body

speaker_labelstring required

Speaker label for this utterance, such as "A" or "B".

Example request

{
  "speaker_label": "A"
}

Response

200

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