---
title: "Create a live transcription session"
method: POST
path: "/live-transcription/create"
tags: ["Live Transcription"]
---

# Create a live transcription session

`POST /live-transcription/create`

## Request

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

Create the media record that a live transcription session writes into, and get back the `mediaId` the streaming connection needs.

Call this first. The record is created in the `liveTranscript` state with its processing progress already at 100, so it appears in the folder straight away and fills with words as the session runs.

Every field in the body is optional. When `folderId` is left out, Speak Ai stores the record in the first folder on the account.

### Sessions that already exist

Pass `meetingAssistantId` to attach the session to a scheduled meeting assistant event. When that event already has a media record, Speak Ai returns the existing `mediaId` instead of creating a second one, so the call is safe to repeat.

## Request body

- object
  - `name` string: Name for the media record. A meeting assistant event overrides this with its own title.
  - `mediaType` string: Recording MIME type, for example `audio/webm` or `video/mp4`. Speak Ai keeps the part before the slash, and stores anything it does not recognise as `audio`.
  - `sourceLanguage` string: Language code for the session. Defaults to `en-us`.
  - `folderId` string: Folder to store the record in. Defaults to the first folder on the account.
  - `tag` string: Single tag stored on the record.
  - `meetingAssistantId` string: Id of a scheduled meeting assistant event to attach the session to.
  - `recorderToken` string: Token of a recorder, when the session comes from an embedded recorder. Speak Ai then takes the folder and the source language from the recorder.

## Response `200`

OK

- object
  - `status` string
  - `data` object
    - `mediaId` string
    - `folderId` string
    - `userId` string
    - `message` string

## Other responses

- `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)