Submit a Comment

NOTE: As of Rev v7.12, userName can be used as a request parameter to submit a comment on behalf of another user. Must be an account admin to use this field for a different user.

PUT
/api/v1/videos/{videoId}/comment

Request Parameters

Name Type Description Required
videoID path GUID for the specific video Yes
comment string Text of the comment Yes
userName string User name of the person submitting the comment. This user must exist in Rev.

Unless the user has been assigned the Account Admin role, this user must match the authenticated user making the API call.

Yes

Example Request

{
  "comment": "This is a great video.",
  "userName": "john.smith"
}

Response Codes

Code Description
200 ok
401 Unauthorized error
500 Internal server error

Get All Comments For a Video

GET
/api/v1/videos/{videoId}/comments

Request Parameters

Name Type Description Required
videoID path GUID for the specific video Yes

Example Response

{
  "id": "2e6523fd-33a0-4feb-8752-ee7c1be26d51",
  "title": "bruce",
  "comments": [
  {
    "id": "f36a10e0-bc57-45dc-99e5-4bdb8a538964",
    "text": "Test comment",
    "username": "admin",
    "firstName": null,
    "lastName": "admin",
    "date": "2016-01-28T08:35:27.299Z",
    "childComments": [
    {
      "id": "dc729aaf-e9ee-4940-9d43-5b6d37d32934",
      "text": "Child Comment",
      "username": "admin",
      "firstName": null,
      "lastName": "admin",
      "date": "2016-01-28T08:35:59.379Z",
      "childComments": null

    },
    {
      "id": "19a4f11e-0842-4c19-a066-5d1d9e3d607b",
      "text": "Second level child",
      "username": "admin",
      "firstName": null,
      "lastName": "admin",
      "date": "2016-01-28T08:36:19.198Z",
      "childComments": []
    },
    {
      "id": "c1bad2c7-9138-4cb7-840a-7d82eb036500",
      "text": "new second",
      "username": "admin",
      "firstName": null,
      "lastName": "admin",
      "date": "2016-01-28T08:42:48.264Z",
      "childComments": []
    } ]
  } ]
}

Response Codes

Code Description
200 ok
401 Unauthorized error
500 Internal server error

Submit a Rating

PUT
/api/v1/videos/{videoId}/rating

Request Parameters

Name Type Description Required
videoID path GUID for the specific video Yes
rating string Numerical rating. Numbers 1 to 5. Must be whole numbers, no decimals. Yes

Example Request

{   
"Rating": "4" 
}

Response Codes

Code Description
200 ok
401 Unauthorized error
500 Internal server error