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