curl --request POST \
--url https://api.rask.ai/v3/projects/{project_id}/transcript/versions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "Before the client review"
}
'{
"object": "transcript_version",
"id": "9",
"number": 9,
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"label": "Before the client review",
"trigger": "manual",
"segment_count": 3,
"author": {
"type": "user",
"email": "maria@example.com"
},
"created_at": "2026-11-03T10:15:02Z",
"voice_assignments": null
}Save a transcript version
Saves the live transcript as a version.
curl --request POST \
--url https://api.rask.ai/v3/projects/{project_id}/transcript/versions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"label": "Before the client review"
}
'{
"object": "transcript_version",
"id": "9",
"number": 9,
"project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
"label": "Before the client review",
"trigger": "manual",
"segment_count": 3,
"author": {
"type": "user",
"email": "maria@example.com"
},
"created_at": "2026-11-03T10:15:02Z",
"voice_assignments": null
}manual (default; always inserts, never pruned) or restore_point (at most one per transcript per 60 s or per Idempotency-Key family; a coalesced call returns the existing restore point).
When to use: to mark a milestone (manual), or before risky edits you may want to undo (restore_point).
Side effects: Adds a manual version, or adds or reuses a restore_point.
Cost: Free.
Idempotency: Idempotency-Key accepted (SDKs send one); retries within 24 h replay the first response.
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_payment_required (409)Authorizations
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
Headers
Optional. 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 to replay the first response.
1 - 255^[\x20-\x7E]+$Path Parameters
Project id (from createProject or listProjects).
64Body
Body of createTranscriptVersion (optional).
Version label.
1 - 200manual (default): always inserts and is never pruned. restore_point: a restore point before risky work; reuses the transcript's restore point from the last 60 s or from an earlier attempt of the same Idempotency-Key family, and is pruned like other automatic versions (never evicting the newest translation_completed and dub_completed versions).
manual, restore_point Response
Created: TranscriptVersion.
A saved transcript version.
Always transcript_version.
transcript_version Version number as a string.
Version number.
Project.
Label (<= 200).
Why a transcript version was saved.
manual: saved by a user (never pruned)autosave: saved by the web editorrestore_point: saved before a risky change, by v3 operations ("Before ") or with createTranscriptVersiontrigger: restore_point; at most one per transcript per 60 s or per Idempotency-Key familytranslation_completed: after a translationdub_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.
manual, autosave, restore_point, translation_completed, dub_completed Segments.
Version author.
Show child attributes
Show child attributes
Save time.
Voices at save time; only in getTranscriptVersion, null in lists.
Show child attributes
Show child attributes