teamworkDevice resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents details about a Microsoft Teams-enabled device that is provisioned for the tenant.

Microsoft Teams-enabled devices are Teams-certified collaboration devices. They include Microsoft Teams Rooms (on Windows and Android), Microsoft Teams Phones, panels, Surface Hubs, and SIP devices. These categories are the same as those available on the Teams admin center under the section Teams devices.

For more information, see Manage your devices in Microsoft Teams.

Note: This does not include mobile phones, laptops, computers, tabs, and so on.

Inherits from entity.


Method Return type Description
List teamworkDevices teamworkDevice collection Get a list of all Microsoft Teams-enabled devices provisioned for a tenant.
Get teamworkDevice teamworkDevice Get the properties of a Microsoft Teams-enabled device.
restart teamworkDeviceOperation Restart the specified Microsoft Teams-enabled device.
runDiagnostics teamworkDeviceOperation Run and generate diagnostic logs for the specified Microsoft Teams-enabled device.
updateSoftware teamworkDeviceOperation Update the software for a Microsoft Teams-enabled device.
List operations teamworkDeviceOperation collection Get a list of operations that are running on a Teams-enabled device.


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, sipAnalog, 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.

teamworkDeviceType values

Member Value Description
unknown 0 Unknown device.
ipPhone 1 IP Phone devices are the desk phones for users to make and receive audio calls or join meetings.
teamsRoom 2 Microsoft Teams Rooms are Windows IoT based devices designed to extend the meeting experience to the conference room.
surfaceHub 3 Surface Hub devices are wall-mounted or roller-stand-mounted devices with interactive whiteboard.
collaborationBar 4 Collaboration bars are Microsoft Teams Rooms on Android used for small meeting spaces.
teamsDisplay 5 Teams display devices are the evolution of Teams phones. These devices are a category of all-in-one dedicated Teams devices that feature an ambient touchscreen and a hands-free experience powered by Cortana.
touchConsole 6 Touch console devices are the optional peripherals to the Teams Rooms on Android to perform all the device operations.
lowCostPhone 7 Low-cost phone devices are cost-effective Microsoft Teams phones.
teamsPanel 8 Microsoft Teams panels are the compact touchscreen devices that display meeting details scheduled via Teams.
sip 9 Session Initiation Protocol (SIP) devices that support Teams calls with the SIP Gateway from Microsoft.
sipAnalog 10 Legacy analog endpoints such as elevator phones, parking lot phones, or factory floor devices, which are registered with Microsoft Teams through the SIP Gateway.
unknownFutureValue 11 Evolvable enumeration sentinel value. Don't use.

teamworkDeviceHealthStatus values

Member Value Description
unknown 0 Unknown health status.
offline 1 The device is offline and can't be used.
critical 2 The state requires urgent attention and action as it might have a significant impact on the performance of the device, or make it unusable for calls or meetings.
nonUrgent 3 The state requires attention because of issues or notifications that might have a minimal impact on the performance of an online device.
healthy 4 The device is online and in good condition.
unknownFutureValue 5 Evolvable enumeration sentinel value. Don't use.


Relationship Type Description
activity teamworkDeviceActivity The activity properties that change based on the device usage.
configuration teamworkDeviceConfiguration The configuration properties of the device.
health teamworkDeviceHealth The health properties of the device.
operations teamworkDeviceOperation collection The async operations on the device.

JSON representation

Here's a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.teamworkDevice",
  "activityState": "String",
  "companyAssetTag": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  "createdDateTime": "String (timestamp)",
  "currentUser": {
    "@odata.type": "microsoft.graph.teamworkUserIdentity"
  "deviceType": "String",
  "hardwareDetail": {
    "@odata.type": "microsoft.graph.teamworkHardwareDetail"
  "healthStatus": "String",
  "id": "String (identifier)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  "lastModifiedDateTime": "String (timestamp)",
  "notes": "String"