Skip to main content
GET
Get a transcript version
Its segments are listed by listTranscriptVersionSegments. When to use: before restoreTranscriptVersion, to show what would come back. Side effects: None. Cost: Free. Idempotency: safe and pure (never writes); retry freely. 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: 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
version_number
integer<int32>
required

Transcript version number.

Required range: 1 <= x <= 2147483647

Response

OK: TranscriptVersion.

A saved transcript version.

object
enum<string>
required

Always transcript_version.

Available options:
transcript_version
id
string
required

Version number as a string.

number
integer<int32>
required

Version number.

project_id
string
required

Project.

label
string | null
required

Label (<= 200).

trigger
enum<string>
required

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
segment_count
integer<int32>
required

Segments.

author
object
required

Version author.

created_at
string<date-time>
required

Save time.

voice_assignments
object[] | null
required

Voices at save time; only in getTranscriptVersion, null in lists.