Skip to main content

Create Video Share Permissions

Creates a share permission on the specified video.

Authorizations: Recordings - ACCESS

Requests

POST /apis/assets/:id/shares
{
"id": "a78758cc-48da-47ad-bc6e-6c8564badb7e",
"shareType": "USER",
"permission": "EDIT",
"name": "viewer"
}

Note

Either id or name must be present. If both are provided, id is used. See User Resources and Group Resources.

Response

Success

{
"data": {
  "id": "a78758cc-48da-47ad-bc6e-6c8564badb7e",
  "shareType": "USER",
  "permission": "EDIT",
  "name": "viewer",
  "email": null
}
}

Error

Code

Payload

Description

400
{"code":"010001", "name":"InputValidation",
"message":<Error message>, "httpStatusCode":400}

Supplied data was insufficient or incorrect.

403
{"code": "030003", "name":"CannotShare",
"message":"Cannot share", "httpStatusCode":403}

User is not allowed to share to this permission ID.

Ex.: User has the WATCH share permission, but is trying to share to the OWN level.

404
{"code":"040002", "name":"AssetNotFound",
"message":"Video not found", "httpStatusCode":404}
Video with UUID Id not found. 
404
{"code":"040004", "name":"UserNotFound",
"message":"User not found", "httpStatusCode":404}
User with provided id or name was not found.
404
{"code":"040005", "name":"GroupNotFound",
"message":"Group not found", "httpStatusCode":404}
Group with provided id or name was not found.
404
{"code":"040025", "name":"SharePermissionNotFound",
"message":"Share permission not found",
"httpStatusCode":404}

The share permission to share with was not found.

409
{"code":"060001", "name":"UserHasNoRoles",
"message":"User has no roles assigned",
"httpStatusCode":409}

Make sure a role is assigned to the user or to at least one of the user's groups.

409
{"code":"060002", "name":"GroupHasNoRoles",
"message":"Group has no roles assigned",
"httpStatusCode":409}

Make sure a role is assigned to the group.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.