Use the Edge API in Microsoft Graph (preview)


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.

The Edge API in Microsoft Graph lets apps manage administrator tasks for organizations. With proper authorization, an app can get access to an organization's browser site lists for Internet Explorer (IE) mode that reside in the cloud, allowing administrators to manage the same data available in the Microsoft 365 admin center. After configuring the appropriate permissions, your app can create browser site lists, add browser sites and shared cookies, and publish the site lists for Microsoft Edge to download.


To call the Edge API in Microsoft Graph, your app needs to acquire an access token. For details about access tokens, see Get access tokens to call Microsoft Graph. Your app also needs the appropriate permissions. For more information, see Browser management permissions.

Common use cases

The Edge API provides methods and actions that support some administrator's tasks in the Microsoft 365 admin center. The following describes common use cases of the API that manages site lists for IE mode.

Use cases REST resources See also
Create, read, update, delete, and publish browser site lists browserSiteList Methods of browserSiteList
Modify the browser sites on a browser site list browserSite Methods of browserSite
Modify the browser shared cookies on a browser site list browserSharedCookie Methods of browserSharedCookie

Next steps

The Edge API in Microsoft Graph can streamline the way you manage your site lists for IE mode. To learn more:

  • Drill down on the methods and properties of the resources most helpful to your scenario.
  • Try the API in the Graph Explorer.