MC1181281 - Microsoft Entra | Iteration 2 (beta): Privileged Identity Management (PIM) APIs to be phased out by Oct 28, 2026

Introduction

Starting Oct 28, 2026, all applications and scripts making calls to Microsoft Entra Privileged Identity Management (PIM) Iteration 2 (beta) APIs for Azure resources, Microsoft Entra roles and Groups will fail.

How this will affect your organization

After Oct 28, 2026, any applications or scripts calling Microsoft Entra PIM Iteration 2 (beta) API endpoints will fail. These calls will no longer return data, which may disrupt workflows or integrations relying on these endpoints. These APIs were released in beta and are being retired, Iteration 3 are generally available (GA) APIs which offer improved reliability and broader scenario support.

What you need to do to prepare

We strongly recommend migrating to the Iteration 3 (GA) APIs, which are generally available. 

• Begin migration planning and testing as soon as possible.
• Halt any new development using Iteration 2 APIs.
• Review documentation for Iteration 3 APIs to ensure compatibility.

Learn more: 

• Privileged Identity Management API Overview
• Privileged Identity Management iteration 2 APIs
• Migrate from PIM iteration 2 APIs to PIM iteration 3 APIs