Pronouns settings path and scope change in Microsoft Graph

Aymen Mohammed

We’re announcing an upcoming breaking change for admins and developers using Microsoft Graph to control pronouns availability in a tenant.

About the breaking change

Using the Microsoft Graph API, a tenant admin can enable, disable, or get settings that manage pronouns in an organization, such as controlling the display within the organization of any pronouns users might have set up for themselves.

Currently, a tenant admin can use Microsoft Graph url{organizationId}/settings/pronouns, which requires the Organization.Read.All or Organization.ReadWrite.All scope.

Starting July 2023, that will change to a new path, and the scope requirement also would change to PeopleSettings.Read.All and PeopleSettings.ReadWrite.All.

What you need to do to prepare

The following is the summary of the changes that will come to pronouns settings in Microsoft Graph:

  • The path would change from{organizationId}/settings/pronouns to
  • The scope required for reading the pronoun settings would change from “Organization.Read.All” to “PeopleSettings.Read.All
  • The scope required for updating the pronouns settings would change from “Organization.ReadWrite.All” to “PeopleSettings.ReadWrite.All
  • The requirement for Global Administrator role would stay the same.

Please note that this change only affects Microsoft Graph API. This does not impact on the features or functionality of the pronouns in Microsoft 365.


1 comment

Discussion is closed. Login to edit/delete existing comments.

  • Javier Negro Dieste 1

    Controlling settings through Graph is great, but when are we be able to read the pronouns value from an user using the Graph API?

Feedback usabilla icon