Skip to main content
POST
Restore a transcript version
Segment ids are re-minted: segment_id_map maps old to new ids. A restore point is saved first; voice assignments are restored when possible. Restoring the current version writes nothing (already_current: true). When to use: to undo edits. Side effects: New segment ids and ETags; segments that differ from the last dub become outdated. Cost: Free. Idempotency: Idempotency-Key required; retries within 24 h with the same key replay the first response (Idempotent-Replayed: true). Concurrency: no ETag. Refused while a dub runs, from its start until its merge ends or it fails (409 dub_in_progress), during processing (409 project_not_ready), and while a translation, segment generation or lip-sync runs or a segment is busy (409 transcript_busy); the required Idempotency-Key makes a retry a replay. Paid text: on a project created through v3, 409 dub_payment_required until a dub of that project is charged. Required scopes: transcripts:write Errors: transcript_not_ready (409), dub_in_progress (409), transcript_busy (409), project_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:write

Headers

Idempotency-Key
string
required

Required. A unique key per logical request (SDKs send a bare UUIDv4; an RFC 9651 quoted string is accepted and unquoted); reuse it unchanged on retries. Kept 24 h per (workspace, acting user).

Required string length: 1 - 255
Pattern: ^[\x20-\x7E]+$

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: TranscriptRestoreResult.

Result of restoreTranscriptVersion. Transient (no id).

object
enum<string>
required

Always transcript_restore_result.

Available options:
transcript_restore_result
restored_version_number
integer<int32>
required

Restored version.

already_current
boolean
required

Nothing was written: the version was already current.

restore_point_version
integer<int32> | null
required

Version saved before the restore.

segment_id_map
object
required

Snapshot segment id -> new live segment id.

effects
object
required

Effects of a restore.