---
title: "Update a live transcription session"
method: POST
path: "/live-transcription/update/{mediaId}"
tags: ["Live Transcription"]
---

# Update a live transcription session

`POST /live-transcription/update/{mediaId}`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/live-transcription/update/{mediaId}`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

Append transcribed words to a live transcription session, and hand Speak Ai the finished recording when the session ends.

Send `words` while the session runs. Speak Ai merges them into sentences by speaker and language and appends them to the transcript already on the record.

Send `aws` once, after the recording is uploaded. That moves the record into the `preparingAnalysis` state, triggers transcoding, and starts the same analysis an uploaded file gets. Include `totalDuration` with it so the duration is right when the uploaded file does not report one.

Both fields are optional and they can be sent in the same call.

## Path parameters

- `mediaId` string, required

## Request body

- object
  - `words` object[]: Words transcribed since the last call, in order.
    - `id` integer: Position of the word in the session.
    - `text` string: The word itself.
    - `confidence` number: Recogniser confidence for the word, from 0 to 1.
    - `language` string: Language code the word was recognised in.
    - `speakerId` string: Speaker the word is attributed to.
    - `instances` object: Where the word sits in the recording.
      - `startInSec` number
      - `endInSec` number
    - `email` string: Email of the speaker, when the session knows it.
    - `userId` string: Speak Ai user id of the speaker, when the session knows it.
  - `aws` object: Location of the finished recording. Send this once, at the end of the session.
    - `bucket` string
    - `key` string
    - `location` string
  - `totalDuration` number: Length of the session in seconds, used when the uploaded file reports a duration of 0.

## Response `200`

OK

- object
  - `status` string
  - `message` string

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)