MC1183294 – M365 Change Digest

One-line summary

Microsoft is retiring the TeamworkDevice (beta) API in Microsoft Graph starting December 8, 2025; use Teams Rooms Pro Management Portal for Teams device management instead.

Similar updates

Details

Summary

The TeamworkDevice (beta) API in Microsoft Graph will be retired starting December 8, 2025. Organizations should transition to managing Teams Rooms on Windows via the Teams Rooms Pro Management Portal (PMP), which will consolidate management for all Teams device types. No admin action is required for retirement.

Body (from Message Center)

[Introduction]

We’re retiring the TeamworkDevice (beta) API from Microsoft Graph starting December 8, 2025.

Instead, we recommend using the Teams Rooms Pro Management Portal (PMP) to manage Teams Rooms on Windows devices, where we will continue to invest in secure, reliable, and supported device management capabilities.

When this will happen:

The retirement will begin gradually on December 8, 2025.

How this affects your organization:

Who is affected: Organizations using applications or integrations that rely on the TeamworkDevice (beta) API in Microsoft Graph.

What will happen:

Applications or integrations using the /beta/TeamworkDevice endpoints will stop working.
There are no plans to support Graph APIs for Teams Devices.
Teams Rooms on Windows should be managed through the Teams Rooms Pro Management Portal (PMP).
PMP is being consolidated as the single portal for managing all Teams device types, including Teams Rooms on Android, Teams Phones, and Teams Panels.
Additional updates on this consolidation effort will be shared in the coming months.

What you can do to prepare:

This change will happen automatically and gradually, starting December 8, 2025. No admin action is required to complete retirement.

If your organization has dependencies on the TeamworkDevice (beta) API, we recommend:

Review any applications, scripts, or integrations that use /beta/TeamworkDevice endpoints.
Update internal documentation.
Notify relevant stakeholders or partners about this upcoming change.

Learn more: Microsoft Teams Rooms Pro Management

Compliance considerations:

No compliance considerations identified, review as appropriate for your organization.

Raw JSON (for debugging)

Expand/collapse the full payload below.

Show/hide raw

{
  "snapshot_item": {
    "action_required_by": null,
    "ai_action_required_by": null,
    "ai_actions": [
      "Review applications using /beta/TeamworkDevice endpoints",
      "Update internal documentation",
      "Notify stakeholders about API retirement"
    ],
    "ai_master_tags": [],
    "ai_model": "gpt-4.1",
    "ai_summary": "Microsoft is retiring the TeamworkDevice (beta) API in Microsoft Graph starting December 8, 2025; use Teams Rooms Pro Management Portal for Teams device management instead.",
    "ai_topics": [
      "Microsoft 365 For The Web",
      "Teams"
    ],
    "category": "planForChange",
    "details_map": {
      "Summary": "The TeamworkDevice (beta) API in Microsoft Graph will be retired starting December 8, 2025. Organizations should transition to managing Teams Rooms on Windows via the Teams Rooms Pro Management Portal (PMP), which will consolidate management for all Teams device types. No admin action is required for retirement."
    },
    "id": "MC1183294",
    "importance": 1,
    "is_major_change": false,
    "last_modified": "2025-11-06T00:16:41Z",
    "ms_products": [
      "Microsoft 365 For The Web"
    ],
    "platforms": null,
    "roadmap_ids": [],
    "services": [
      "Microsoft 365 for the web"
    ],
    "severity": "normal",
    "tags": [
      "User impact",
      "Admin impact",
      "Retirement"
    ],
    "title": "Retirement of the TeamworkDevice (beta) API in Microsoft Graph"
  }
}