What's new in Microsoft Graph

See highlights of what's new in the recent two months in Microsoft Graph, what's added earlier, and how you can share your ideas. For a detailed list of API-level updates, see the API changelog.

November 2021: New and generally available

Files

Get the state of a drive as of a specific time by specifying the corresponding URL-encoded timestamp. See an example.

Identity and access | Identity and sign-in

• Run campaigns and enforce users to register at sign-in time to set up targeted authentication methods.
• Configure an Apple identity provider in an Azure AD B2C tenant.

November 2021: New in preview only

Cloud communications | Online meeting

Automatically admit new types of participants in an online meeting and bypass the meeting lobby:

• Only people the organizer invites.
• Only the participants from the same company.

Devices and apps | Cloud PC

• Define a configuration of how a provisioned Cloud PC device can join Azure Active Directory (Azure AD): either cloud-only and join only to Azure AD, or hybrid and join on-premises Active Directory and Azure AD.
• Get the gallery image resource of the current organization which can be used to provision a Cloud PC.

Devices and apps | Device updates

• Use safeguard settings to opt-out of safeguards against likely issues in a deployment.
• Support for a deployment state where a deployment is faulted due to the content no longer being deployable, for example, at the end of service.

Identity and access | Directory management

• Define and assign custom security attributes to Azure AD objects. Use these attributes to store information, categorize objects, or enforce fine-grained access control over specific Azure resources. Use these attributes with Azure attribute-based access control (Azure ABAC).
• Create a group within an administrative unit.

Reports | Microsoft 365 usage reports

Microsoft 365 usage reports in JSON output type are no longer strongly typed and are of the type Edm.Stream. For more information, see OData property changes to Microsoft 365 usage reports API in Microsoft Graph.

Teamwork

Mark a chat as read, or unread for a user.

October 2021: New and generally available

Cloud communications | Calls

• Transfer an active peer-to-peer call.
• Transfer a group call to a specified participant (transferee).

Cloud communications | Online meetings

Support multiple toll and toll-free numbers for dial-in phone access (audio conferencing) of an online meeting.

Education

Support a media file or some other external generic resource as an assignment resource.

Identity and access | Applications

• To drive the consent experience for an application, specify the resources that the app needs to access, including the set of OAuth 2.0 delegated permissions and application roles that the application requires.
• Limit the number of required APIS to 50, and required permissions to 400 per application.

Identity and access | Directory management

• Set extension attributes for a device and manage them in Azure Active Directory on device creation or update.
• Get a BitLocker recovery key on behalf of the signed-in user who's the device owner or in an appropriate role. Getting a recovery key generates an audit log, in parity with the end user experience.

Identity and access | Governance

Specify a list of additional users or group members to be notified of the access review progress, in the additionalNotificationRecipients property of an accessReviewScheduleDefinition.

Identity and access | Identity and sign-in

Specify the devices in a conditional access policy, as part of the conditions that govern when the policy applies.

Personal contacts

Enable support for delegated permissions (Contacts.Read or Contacts.ReadWrite) for profilePhoto resources in personal Microsoft accounts.

Teamwork

• Get all chat messages across all channels in a team.
• Get all messages from all the chats that a user participates in, including one-on-one chats, group chats, and meeting chats.
• Check out the licensing and payment models that apply to Microsoft Teams APIs in Microsoft Graph.

Users

User licenses for Azure Active Directory (Azure AD) services now support a timestamp for when the state of the license assignment is last updated.

October 2021: New in preview only

Applications

Use federated identity credentials to manage an application's credentials and allow an organization's cloud applications to access Azure AD without using secrets and certificates.

Cloud communications | Calls

Identify a call participant, by using the participantId property of the participantInfo resource type.

Cloud communications | Online meetings

Enable meeting registration and organize online meetings as a webinar. Associate the meeting with a registration page, and choose to enroll everyone or only organization members as meeting registrants.

Customer booking

• Support the following attributes for a booking service:
  • Enable sending SMS notifications to customers for their appointments (smsNotificationsEnabled property).
  • The URL that customers can use to access the service (webUrl property).
• Book an appointment with one or more of the following attributes:
  • Specify the customer's time zone (customerTimeZone property).
  • Specify the URL for an online appointment (joinWebUrl property).
  • Enable SMS notifications to the customer for the appointment (smsNotificationsEnabled property).
• Specify one or more addresses and phone numbers for a customer.
• Specify the time zone for a staff member.

Devices and apps | Cloud PC

List the Windows 365 service plans that an organization subscribes to for their Cloud PCs. Under each service plan type (business or enterprise), an organization can choose to subscribe from a range of plan configurations that vary by attributes like vCPU, RAM, and storage.

Identity and access | Directory management

Specify key credential configuration settings that can be configured to enable restrictions to an application or service principal.

Identity and access | Governance

Enable the following additional settings to review an access package assignment policy:

• Default behavior if request is not reviewed in a specified duration (accessReviewTimeoutBehavior property).
• Display recommendations to reviewer (isAccessRecommendationEnabled property).
• Require reviewer to provide justification for approval (isApprovalJustificationRequired property).

Identity and access | Identity and sign-in

• Specify whether continuous access evaluation policy settings should be or have been migrated to the conditional access policy.
• As a part of Azure Active Directory conditional access, use a new session control, continuousAccessEvaluationSessionControl, to continuously evaluate access and make access decisions.

Search | Index

• Specify settings for the search experience of content in an external connection. For example, a display template for search results, and a rule to select the display template.
• Relate one or more external groups to an external connection. For example, an external group such as a business unit or work team can determine permissions to the content in the data source represented by the external connection.
• Can optionally specify the ID of a Teams app in an external connection in the connectorId property.

Users

Validate a password in real time against an organization's password validation policy, as a user types the password. Get detailed information from the validation against rules in the policy.

Want to stay in the loop?

Here are some ways we can engage:

• Are there scenarios you'd like Microsoft Graph to support? Suggest and vote for new features at Microsoft Tech Community. Some new features originate as popular requests from the developer community. The Microsoft Graph team regularly evaluates customer needs and releases new features in the following order:

  1. Debut in preview status. Any related REST API updates are in the beta endpoint (https://graph.microsoft.com/beta).

  2. Promoted to general availability (GA) status, if sufficient feedback indicates viability. Any related REST API updates are added to the v1.0 endpoint (https://graph.microsoft.com/v1.0).

• Be an active member in the Microsoft Graph community! Join the monthly Microsoft Graph community call.

• Sign up for the Microsoft 365 developer program, get a free Microsoft 365 subscription, and start developing!

See also

• Check out the Microsoft Graph developer blog periodically for release announcements and helpful resources.
• Browse details of Microsoft Graph API additions, and API behavior updates in the changelog.
• Find highlights of earlier releases.
• Learn more about versioning, support, and breaking change policies for Microsoft Graph.