New in Graph – See and Manage Teams Devices!
Exciting new functionality has surfaced in Microsoft Graph over the last few days. It’s yet to hit the official Changelog but it’s documented as Beta functionality (meaning it’s available for everyone to use but is not supported for production use)
What can you do?
There are several new API endpoints covering Provisioned Devices, Activity, Configuration, Health and Operation, but it looks as though applications using these APIs will be able to:
- Get a list of managed Teams devices, such as IPPhones, Teams Room Systems, Surface Hubs, Collaboration Bars, Teams Displays, Touch Consoles, Low Cost Phones, Teams Panels and SIP devices. Information about the device will include the hardware identifiers, company asset tags, health and activity states and the current user.
- Get the health status of devices
- Restart devices
- Run Diagnostics on devices
- Remotely apply software updates
What permissions are needed?
There are some specific new permissions that applications will need:
- TeamworkDevice.Read.All
- TeamworkDevice.ReadWrite.All
It looks as though Application permissions are supported for all calls, which is great news for developers looking to build autonomous monitoring and pro-active maintenance solutions that don’t have a user present.
It’s free … for now.
There is an interesting banner on each page of the documentation for these new calls, which says:
Note: Microsoft is temporarily offering usage of the APIs for managing Microsoft Teams-enabled devices at no charge. Microsoft expects to charge for the use of some or all of these APIs in the future. Microsoft will provide advanced notice of pricing changes. For details about the current licensing model, see Licensing and payment requirements.
https://docs.microsoft.com/graph/api/teamworkdevice-list?view=graph-rest-beta&WT.mc_id=M365-MVP-5001530
The link is to the same licensing and payment page that is used for the new Export API and Change Notifications, although in this case it is much less clear whether applications that use this functionality would ever be classed as a “security or compliance function” and be able to use model=A charging (which includes a built-in capacity).
How can I find out more?
Here are all the new endpoints:
- List teamworkDevices
- Get teamworkDevice
- teamworkDevice: restart
- teamworkDevice: updateSoftware
- Get teamworkDeviceActivity
- Get teamworkDeviceConfiguration
- Get teamworkDeviceHealth
- List teamworkDeviceOperations
- Get teamworkDeviceOperation
Written by Tom Morgan
Tom is a Microsoft Teams Platform developer and Microsoft MVP who has been blogging for over a decade. Find out more.
Related posts:
New in Microsoft Graph: API calls to get EVERYTHING a user sent in Chat, All Chats in Channels, and support for Apps in Chat
Microsoft Teams Export APIs and Change Notifications for Chats & Channels will be chargeable
It’s now much easier to send proactive bot messages to Microsoft Teams users, thanks to new permissions
Weekly Update 31 January 2022 – New SPFx version in public preview, new API endpoints for Teams devices, 270M users!
Using the Microsoft Teams BETA Graph API calls? They may be about to break on you… 3 API calls going away soon
Interesting.
Could it be, that the “free for now” is simply because these APIs look surprisingly related to the Teams Rooms Premium License/Service, which is extra $$$.
So, to make it not too easy to design more or less competing services for devices to the ones available now or in the future, there is a price tag on it?
Just a wild guess..