# Versions

After upload, an initial version of the dub is automatically created for each language. You can create additional
versions for each language to act as snapshots in time as you edit or to edit independently, with each version
identified by a unique version ID.

## Get a dubbing version

 - [GET /v1/versions/{version_id}](https://docs.panjaya.ai/apis/versions/versions-get_version.md): Retrieve detailed information about a specific dubbing version by providing its unique Version ID.

#### Response Details

The response includes metadata about the version, such as its current status and progress in the dubbing process.

The  field provides a link to , where you can fine-tune the dubs further.
This URL is not signed and requires authentication. Use the  endpoint (as described below) to pre-sign a
URL.

If the final video has been successfully generated, the response will also include a signed URL in the 
field. This URL allows you to securely download the fully synchronized video, complete with lip and body language alignment.

#### Version Status

The  field indicates the current state of the version. Possible values include:

- : The version is currently being prepared for editing.
- : The version is ready for editing and refinement in the Panjaya Dubbing Studio web interface.
- : The version is being processed to generate the final video. Editing is temporarily disabled during this stage.
- : The version has been successfully generated and is ready for download.
- : An error occurred during the version processing.

## Revise version

 - [PATCH /v1/versions/{version_id}/revise](https://docs.panjaya.ai/apis/versions/versions-revise_version.md): Revert a generated dubbing version to editing mode in the Panjaya Dubbing Studio.

Once a dubbing version is successfully generated, its status changes to , allowing only preview access to
 the generated video. If further edits are needed, use this endpoint to restore the version to an .

: This action permanently removes the generated video and its associated .

If  provided this endpoint will return a URL to the Panjaya Dubbing Studio.
See the Create a signed URL endpoint for more details.

#### Version Status
This operation is only allowed if the version status is either ,  or . Upon execution,
 the version status will be updated to , allowing further modifications.

## Generate version

 - [POST /v1/versions/{version_id}/generate](https://docs.panjaya.ai/apis/versions/versions-generate_version.md): Initiate the generation process for a dubbing version. Once the process is complete,
and you'll receive notifications via  or a , if configured (see below). Your final video will
then be available for download.


#### Version Status
This operation is only allowed if the version status is . Upon execution,
 the version status will be updated to , until the generation process is completed,
after which the version status will be updated to .

## Create a signed URL for version

 - [POST /v1/versions/{version_id}/studio_url](https://docs.panjaya.ai/apis/versions/versions-get_studio_url_for_version.md): Create a URL that allows anyone with the link to access the Panjaya Dubbing Studio for a specific dubbing version.

This endpoint is useful for sharing a version with collaborators or reviewers who need to make edits or QC the dubbing,
without requiring them to log in.

The generated URL provides a pre-signed access to the Panjaya Dubbing Studio, where users can view the dubbing version, adjust the
text, and fine-tune the dubbing. The access is limited to the specific version and does not allow access to other
versions or assets.

Adjust the  parameter to specify the duration in minutes for which the URL will remain valid.
The default expiration time is 3 hours.

## Get a version's subtitles

 - [GET /v1/versions/{version_id}/srt](https://docs.panjaya.ai/apis/versions/versions-get_version_srt.md): Fetch the current version's source transcript or target translation, formatted as an SRT file.

Use the  query parameter to indicate the desired subtitles - Set to  for fetching the transcript in the asset's source language,
or  for fetching the current translation in the version's target language.