PATCH
/
api
/
projects
/
{projectId}
/
videos
/
{videoId}
curl -X PATCH \
  https://studio.dubformer.ai/api/projects/PROJECT_ID/videos/VIDEO_ID \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "New video name",
    "dstLangs": ["en", "fr"],
    "processingType": "standard",
    "status": "in_progress",
    "remark": "Updated video description"
  }'

{
  "id": "vid_7a92c36d4fe3c",
  "name": "New video name",
  "status": "in_progress",
  "processingType": "standard",
  "srcLang": "ru",
  "dstLangs": ["en", "fr"],
  "videoUrl": "https://...",
  "remark": "Updated video description",
  "createdAt": "2024-06-01T12:00:00.000Z",
  "updatedAt": "2024-06-01T12:34:56.000Z"
}
This endpoint allows you to update various properties of a video in a project: name, translation languages, processing type, status, and remark.

​
Path Parameters

​
projectId
string
required
The unique identifier of the project.
​
videoId
string
required
The unique identifier of the video to update.

​
Request Body

​
name
string
New name for the video.
​
dstLangs
string[]
New translation languages for the video.
​
processingType
string
New processing type for the video.
​
status
string
New status for the video.
​
remark
string
New remark for the video.
curl -X PATCH \
  https://studio.dubformer.ai/api/projects/PROJECT_ID/videos/VIDEO_ID \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "New video name",
    "dstLangs": ["en", "fr"],
    "processingType": "standard",
    "status": "in_progress",
    "remark": "Updated video description"
  }'

​
Response

​
id
string
required
The unique identifier of the video.
​
name
string
required
The name of the video.
​
status
string
required
The status of the video.
​
processingType
string
required
The processing type of the video.
​
srcLang
string
required
The source language of the video.
​
dstLangs
string[]
required
The translation languages of the video.
​
videoUrl
string
required
The URL of the video file.
​
remark
string
The remark for the video.
​
createdAt
string
required
Creation timestamp.
​
updatedAt
string
required
Last update timestamp.
{
  "id": "vid_7a92c36d4fe3c",
  "name": "New video name",
  "status": "in_progress",
  "processingType": "standard",
  "srcLang": "ru",
  "dstLangs": ["en", "fr"],
  "videoUrl": "https://...",
  "remark": "Updated video description",
  "createdAt": "2024-06-01T12:00:00.000Z",
  "updatedAt": "2024-06-01T12:34:56.000Z"
}

{
  "error": "No valid fields to update"
}

​
Notes

  • You can update one or several fields in a single request
  • The video must exist and belong to a project that you have access to
  • The response format matches the get-project-video endpoint