Share a Recording with a User

This command sets the access permission (either WATCH, EDIT, OWN, or custom permission ID) of the specified recording with the specified user.

Authorizations: All

shareRecordingWithUser username permissionId recordingId

Name

Description

username

The HMP user name specified for the user. username is case-insensitive.

permissionId

The access permission to assign to this user:

recordingId

The ID of a HMP recording.

Success

OK

Error

Error	Description
ERROR\|010003\|Expected 3 parameter(s). Got Y parameter(s)	Calling `shareRecordingWithUser` requires 3 parameters.
ERROR\|010001\|'Y' is not a UUID	The `recordingId` provided must be a UUID.
ERROR\|010001\|Permission must be one of: WATCH, EDIT, OWN	Validation failed on `'permission'`. Verify that it is set to `WATCH`, `EDIT`, or `OWN`.
ERROR\|070008\|Error searching for a user	An internal error occurred while searching for user `'username'`.
ERROR\|040004\|User not found	A user with UUID `'username'` was not found.
ERROR\|060001\|User has no roles assigned	Make sure a role is assigned to the user or to at least one of the user's groups.
ERROR\|040002\|Recording not found	A recording with UUID `'recordingId'` was not found.
ERROR\|030003\|Cannot share	User is not allowed to share to this permission ID. Ex.: User has the WATCH permission, but is trying to share to the OWN level.

This example uses a default HMP access permission.

shareRecordingWithUser creator OWN f678f415-0665-48cd-b141- 1e95283469f1

OK

This example uses a custom access permission.

shareRecordingWithUser InfoDev 12b0cc54-9018-42c2-9dfb-3f7707a09829
  f678f415-0665-48cd-b141-1e95283469f1

OK