Skip to main content
GET
List transcript versions
Versions other than manual beyond 50 are pruned oldest first, never the newest translation_completed and dub_completed versions. When to use: to find a version to inspect or restore. Side effects: None. Cost: Free. Idempotency: safe and pure (never writes); retry freely. Pagination: limit (default 20, max 100) and cursor; follow next_cursor until has_more is false. Paid text: on a project created through v3, 409 dub_payment_required until a dub of that project is charged. Required scopes: transcripts:read Errors: transcript_not_ready (409), dub_payment_required (409)

Authorizations

Authorization
string
header
required

API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).

Scopes

transcripts:read

Path Parameters

project_id
string
required

Project id (from createProject or listProjects).

Maximum string length: 64

Query Parameters

limit
integer<int32>
default:20

Page size.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from next_cursor; keep the same filters on every page.

Maximum string length: 2048
trigger
enum<string>[]

Comma-separated triggers.

Maximum array length: 5

Why a transcript version was saved.

  • manual: saved by a user (never pruned)
  • autosave: saved by the web editor
  • restore_point: saved before a risky change, by v3 operations ("Before ") or with createTranscriptVersion trigger: restore_point; at most one per transcript per 60 s or per Idempotency-Key family
  • translation_completed: after a translation
  • dub_completed: after a dub

Versions other than manual beyond 50 per transcript are pruned oldest first, except the newest translation_completed and dub_completed versions.

Available options:
manual,
autosave,
restore_point,
translation_completed,
dub_completed

Response

OK: TranscriptVersionList.

A page of TranscriptVersion (the list envelope shared by every list).

object
enum<string>
required

Always list.

Available options:
list
data
object[]
required

Items of this page.

next_cursor
string | null
required

Pass as cursor for the next page; null on the last page.

has_more
boolean
required

More items exist (a page may hold fewer than limit items while has_more is true).