Migrate a Video
This endpoint is used during migrations to Rev from another system. During video import, you may want to retain the original uploader, upload date, and publish date. As a result, this API allows you to set only these fields to do so.
You can also use this endpoint to edit only these fields for previously added videos in the system if needed. This avoids the requirement of setting all fields when using other video editing endpoints.
Path Parameters
| Parameter | Type | Validations |
|---|---|---|
| videoId | string, required | ID of video to edit/migrate. |
Request Body
application/json
{
"userName": "john.smith",
"whenUploaded": "2019-08-06T16:57:14.249Z",
"publishDate": "2019-08-06"
}
| Parameter | Type | Validations |
|---|---|---|
| userName | string, optional | The uploader will be set to this user. |
| whenUploaded | string, optional | Upload date will be set to this value. Example: 2019-02-26 15:53:12 |
| publishDate | string, required |
By default, the publishDate is set to the current date the video is set to Active status. You can also set the publishDate to a date in the future to make the video Active at that time. If the video is already Active, the publishDate can be set to a date in the past. Note: Format must be YYYY-MM-DD to avoid generating an error. |
REQUEST: Migration
curl -X PUT
https://MY_REV_URL.com/api/v2/videos/f63b69c8-3646-4350-a8e7-df263aa96f9f/migration
-H 'Authorization: VBrick o7i9j2G2dTrDbs58_g0MyrsLpSwEARA2f3da2TFQtJy2nhmBvty6dwMJTDc8tI_BEyKJzDJijsZsFZe5uiZr_jiXL_tBWBQ6dACFujrj0Fg1IBHn9Hckqc-htGQXqi5HaflcQBV1IOblaa6w-mfkBg2'
-H 'Cache-Control: no-cache'
-H 'Content-Type: application/json'
-H 'Postman-Token: 060b7375-b7ac-42fd-8cda-3372f1da85c0'
-d '{
"userName": "johnsmith",
"whenUploaded": "2017-08-31T15:00:10.471Z"
}'