TeamworkDevice.ReadWrite.All
Allow the app to read and write the management data for Teams devices on behalf of the signed-in user.
Graph Methods
Type: A = Application Permission, D = Delegate Permission
| Ver |
Type |
Method |
| V1 |
A,D |
GET /teamwork/devices |
| V1 |
A,D |
GET /teamwork/devices/{teamworkDeviceId} |
| V1 |
A,D |
GET /teamwork/devices/{teamworkDeviceId}/activity |
| V1 |
A,D |
GET /teamwork/devices/{teamworkDeviceId}/configuration |
| V1 |
A,D |
GET /teamwork/devices/{teamworkDeviceId}/health |
| V1 |
A,D |
GET /teamwork/devices/{teamworkDeviceId}/operations |
| V1 |
A,D |
GET /teamwork/devices/{teamworkDeviceId}/operations/{teamworkDeviceOperationId} |
| V1 |
A,D |
POST /teamwork/devices/{teamworkDeviceId}/restart |
| V1 |
A,D |
POST /teamwork/devices/{teamworkDeviceId}/runDiagnostics |
| V1 |
A,D |
POST /teamwork/devices/{teamworkDeviceId}/updateSoftware |
Delegate Permission
|
|
| Id |
ddd97ecb-5c31-43db-a235-0ee20e635c40 |
| Consent Type |
Admin |
| Display String |
Read and write Teams devices |
| Description |
Allow the app to read and write the management data for Teams devices on behalf of the signed-in user. |
Application Permission
|
|
| Id |
79c02f5b-bd4f-4713-bc2c-a8a4a66e127b |
| Display String |
Read and write Teams devices |
| Description |
Allow the app to read and write the management data for Teams devices, without a signed-in user. |
Resources
| Property |
Type |
Description |
| activityState |
teamworkDeviceActivityState |
The activity state of the device. The possible values are: unknown, busy, idle, unavailable, unknownFutureValue. |
| companyAssetTag |
String |
The company asset tag assigned by the admin on the device. |
| createdBy |
identitySet |
Identity of the user who enrolled the device to the tenant. |
| createdDateTime |
DateTimeOffset |
The UTC date and time when the device was enrolled to the tenant. |
| currentUser |
teamworkUserIdentity |
The signed-in user on the device. |
| deviceType |
teamworkDeviceType |
The type of device. The possible values are: unknown, ipPhone, teamsRoom, surfaceHub, collaborationBar, teamsDisplay, touchConsole, lowCostPhone, teamsPanel, sip, unknownFutureValue. |
| hardwareDetail |
teamworkHardwareDetail |
A collection of hardware-related properties. For example, oemSerialNumber and model. |
| healthStatus |
teamworkDeviceHealthStatus |
The health status of the device. The possible values are: unknown, offline, critical, nonUrgent, healthy, unknownFutureValue. |
| id |
String |
Device identifier. Inherited from entity. |
| lastModifiedBy |
identitySet |
Identity of the user who last modified the device details. |
| lastModifiedDateTime |
DateTimeOffset |
The UTC date and time when the device detail was last modified. |
| notes |
String |
The notes added by the admin to the device. |
| Property |
Type |
Description |
| activePeripherals |
teamworkActivePeripherals |
The active peripheral devices attached to the device. |
| createdBy |
identitySet |
Identity of the user who created the device activity document. |
| createdDateTime |
DateTimeOffset |
The UTC date and time when the device activity document was created. |
| id |
String |
Document identifier. Inherited from entity. |
| lastModifiedBy |
identitySet |
Identity of the user who last modified the device activity details. |
| lastModifiedDateTime |
DateTimeOffset |
The UTC date and time when the device activity detail was last modified. |
| Property |
Type |
Description |
| cameraConfiguration |
teamworkCameraConfiguration |
The camera configuration. Applicable only for Microsoft Teams Rooms-enabled devices. |
| createdBy |
identitySet |
Identity of the user who created the device configuration document. |
| createdDateTime |
DateTimeOffset |
The UTC date and time when the device configuration document was created. |
| displayConfiguration |
teamworkDisplayConfiguration |
The display configuration. |
| hardwareConfiguration |
teamworkHardwareConfiguration |
The hardware configuration. Applicable only for Teams Rooms-enabled devices. |
| id |
String |
Document identifier. Inherited from entity. |
| lastModifiedBy |
identitySet |
Identity of the user who last modified the device configuration. |
| lastModifiedDateTime |
DateTimeOffset |
The UTC date and time when the device configuration was last modified. |
| microphoneConfiguration |
teamworkMicrophoneConfiguration |
The microphone configuration. Applicable only for Teams Rooms-enabled devices. |
| softwareVersions |
teamworkDeviceSoftwareVersions |
Information related to software versions for the device, such as firmware, operating system, Teams client, and admin agent. |
| speakerConfiguration |
teamworkSpeakerConfiguration |
The speaker configuration. Applicable only for Teams Rooms-enabled devices. |
| systemConfiguration |
teamworkSystemConfiguration |
The system configuration. Not applicable for Teams Rooms-enabled devices. |
| teamsClientConfiguration |
teamworkTeamsClientConfiguration |
The Teams client configuration. Applicable only for Teams Rooms-enabled devices. |
| Property |
Type |
Description |
| connection |
teamworkConnection |
Information about the connection status. |
| createdBy |
identitySet |
Identity of the user who created the device health document. |
| createdDateTime |
DateTimeOffset |
The UTC date and time when the device health document was created. |
| hardwareHealth |
teamworkHardwareHealth |
Health details about the device hardware. |
| id |
String |
Doucument identifier. Inherited from entity. |
| lastModifiedBy |
identitySet |
Identity of the user who last modified the device health details. |
| lastModifiedDateTime |
DateTimeOffset |
The UTC date and time when the device health detail was last modified. |
| loginStatus |
teamworkLoginStatus |
The login status of Microsoft Teams, Skype for Business, and Exchange. |
| peripheralsHealth |
teamworkPeripheralsHealth |
Health details about all peripherals (for example, speaker and microphone) attached to a device. |
| softwareUpdateHealth |
teamworkSoftwareUpdateHealth |
Software updates available for the device. |
| Property |
Type |
Description |
| completedDateTime |
DateTimeOffset |
Time at which the operation reached a final state (for example, Successful, Failed, and Cancelled). |
| createdBy |
identitySet |
Identity of the user who created the device operation. |
| createdDateTime |
DateTimeOffset |
The UTC date and time when the device operation was created. |
| error |
operationError |
Error details are available only in case of a failed status. |
| id |
String |
Document identifier. Inherited from entity. |
| lastActionBy |
identitySet |
Identity of the user who last modified the device operation. |
| lastActionDateTime |
DateTimeOffset |
The UTC date and time when the device operation was last modified. |
| operationType |
teamworkDeviceOperationType |
Type of async operation on a device. The possible values are: deviceRestart, configUpdate, deviceDiagnostics, softwareUpdate, deviceManagementAgentConfigUpdate, remoteLogin, remoteLogout, unknownFutureValue. |
| startedDateTime |
DateTimeOffset |
Time at which the operation was started. |
| status |
String |
The current status of the async operation, for example, Queued, Scheduled, InProgress, Successful, Cancelled, and Failed. |