Video Approvals
These API calls support adding approval processes for video into third party systems. Using these API calls, users can upload video from other systems and admin can approve video as well without having to login into the Rev portal.
List Approval Processes
This will return available approval processes for the user that is authenticated to Rev making this API call.
GET
/api/v2/videos/approval/templates
Request Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| none |
Example Response
[
{
"id": "fe73fec5-35c4-4f55-abdc-0192f326f9a0",
"name": "subject matter review"
}
]
Response Codes
| Code | Description |
|---|---|
| 200 | ok |
| 401 | Unauthorized error |
| 500 | Internal server error |
Submit a Video for Approval
PUT
/api/v2/videos/{id}/approval/submitted/{templateId}
Request Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| id | path | GUID for the video | Yes |
| templateId | path | GUID for the approval process template | Yes |
Response Codes
| Code | Description |
|---|---|
| 200 | ok |
| 401 | Unauthorized error |
| 500 | Internal server error |
List Videos Pending Approval
GET
/api/v2/videos/approval/pending
Request Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| count | integer | Number of videos to return. Should not exceed 250 for better performance (By default count is 50) |
Example Response
[
{
"id": "13a24fc2-4fc5-4ba9-88af-f58624ad10e0",
"title": "Presentation Recording",
"htmlDescription": "Recording of the presentation given to this internal group",
"approvalStatus": "Pending",
"ApprovalProcessName": "Subject matter review",
"ApprovalProcessStepName": "Manager review",
"ApprovalProcessStepNumber": 1,
"ApprovalProcessStepsCount": 2
}
]
Response Codes
| Code | Description |
|---|---|
| 200 | ok |
| 400 | Bad request |
| 401 | Unauthorized error |
| 500 | Internal server error |
Approve a Video
PUT
/api/v2/videos/{id}/approval/approved
Request Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| ID | path | GUID for the video to be approved | Yes |
| reason | string | Any comments regarding the video. |
Example Request
{
"reason":"video looks good to be published"
}
Response Codes
| Code | Description |
|---|---|
| 200 | ok |
| 401 | Unauthorized error |
| 500 | Internal server error |
Reject a Video
PUT
/api/v2/videos/{id}/approval/rejected
Request Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| ID | path | GUID for the video to be approved | Yes |
| reason | string | Any comments regarding the video. |
Example Request
{
"reason":"video needs to be edited to remove this content around this topic"
}
Response Codes
| Code | Description |
|---|---|
| 200 | ok |
| 401 | Unauthorized error |
| 500 | Internal server error |
- Available Processes
-
List Approval Processes
This will return available approval processes for the user that is authenticated to Rev making this API call.
GET/api/v2/videos/approval/templatesRequest Parameters
Name Type Description Required none Example Response
[ { "id": "fe73fec5-35c4-4f55-abdc-0192f326f9a0", "name": "subject matter review" } ]Response Codes
Code Description 200 ok 401 Unauthorized error 500 Internal server error - Submit for Approval
-
Submit a Video for Approval
PUT/api/v2/videos/{id}/approval/submitted/{templateId}Request Parameters
Name Type Description Required id path GUID for the video Yes templateId path GUID for the approval process template Yes Response Codes
Code Description 200 ok 401 Unauthorized error 500 Internal server error - Pending
-
List Videos Pending Approval
GET/api/v2/videos/approval/pendingRequest Parameters
Name Type Description Required count integer Number of videos to return. Should not exceed 250 for better performance (By default count is 50) Example Response
[ { "id": "13a24fc2-4fc5-4ba9-88af-f58624ad10e0", "title": "Presentation Recording", "htmlDescription": "Recording of the presentation given to this internal group", "approvalStatus": "Pending", "ApprovalProcessName": "Subject matter review", "ApprovalProcessStepName": "Manager review", "ApprovalProcessStepNumber": 1, "ApprovalProcessStepsCount": 2 } ]Response Codes
Code Description 200 ok 400 Bad request 401 Unauthorized error 500 Internal server error - Approve
-
Approve a Video
PUT/api/v2/videos/{id}/approval/approvedRequest Parameters
Name Type Description Required ID path GUID for the video to be approved Yes reason string Any comments regarding the video. Example Request
{ "reason":"video looks good to be published" }Response Codes
Code Description 200 ok 401 Unauthorized error 500 Internal server error - Reject
-
Reject a Video
PUT/api/v2/videos/{id}/approval/rejectedRequest Parameters
Name Type Description Required ID path GUID for the video to be approved Yes reason string Any comments regarding the video. Example Request
{ "reason":"video needs to be edited to remove this content around this topic" }Response Codes
Code Description 200 ok 401 Unauthorized error 500 Internal server error