Comment on page
Device Sharing
This mutation allows you to add or remove device and service sharing from your account to other users. DeviceId and ServiceId can be retrieved here.
Parameters | Data Type | Description |
|---|---|---|
deviceId | String | required The ID of the device to share |
email | [String] | required The email(s) of the user you want to share the device with, or you can specify an array of emails. |
scripting | Boolean | Grants bulk scripting permission to the user (default: false) |
notify | Boolean | The user will be notified (default: true) |
action | String | ADD, REMOVE, LEAVE (default: ADD) |
services | [ServiceSharingOptions] | For sharing only a subset of services. This field and below is not required if sharing all services of a device |
serviceId | String | The ID of the specific service associated with the deviceID |
This example shares and notifies
[email protected] that deviceId 80:00:00:00:12:34:56:78 has been shared and all services associated with it but does not grant bulk scripting permissions.mutation {
share(deviceId: "80:00:00:00:12:34:56:78",
email: "[email protected]",
scripting: false,
notify: true,
action: ADD)
}
This example shares a service and removes a share of another service on the same device to multiple users.
mutation {
share(deviceId: "80:00:00:00:12:34:56:78",
email: [
],
notify: true,
services: [
{serviceId: "80:00:00:00:12:34:56:79", action: ADD},
{serviceId: "80:00:00:00:12:34:56:79", action: REMOVE}
]
If you want to leave a shared device that another user has shared with you previously
Response Example
{
"data": {
"share": true
}
}
Last modified 1yr ago