List Approval Processes

This will return available approval processes for the user that is authenticated to Rev making this API call.

GET
/api/v1/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/v1/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

Approve a Video

PUT
/api/v1/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/v1/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

List Videos Pending Approval

NOTES: approvalStatus, ApprovalProcessName, ApprovalProcessStepName, ApprovalProcessStepNumber, ApprovalProcessStepsCount are available as of Rev v7.15

GET
/api/v1/videos/approval/pending

Request Parameters

Name Type Description Required
none

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