Skip to main content
POST
Create a transcription job from an uploaded file

Body

application/json
upload_token
string
required

Upload token returned by POST /api/v1/uploads/init

file_name
string
required

Original file name

Example:

"meeting.mp3"

language
string
required

Spoken language code

Example:

"en"

diarize
boolean
required

Whether to diarize (separate speakers)

Example:

false

name
string

Display name for the resulting transcription(s)

Maximum string length: 255
Example:

"Team weekly sync"

Response

Transcription job created

id
string
required

Transcription job ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>
required

Job lifecycle status

Available options:
queued,
processing,
completed,
partial,
failed
Example:

"queued"