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.