Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Microsoft Graph provides a unified programmability model that you can use to access data in Microsoft 365, Windows, and Enterprise Mobility + Security. This article provides information about what's new in Microsoft Graph APIs, documentation, SDKs, and more.
For more detailed API-level updates, see the Microsoft Graph API changelog.
For details about previous updates to Microsoft Graph, see Microsoft Graph what's new history.
Important
Features in preview status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps.
November 2026: New and generally available
Backup and recovery | Microsoft 365 backup and storage
- Added request guidance and examples for using retentionSettings when you create or update Exchange, OneDrive for Business, and SharePoint protection policies to configure how long backups are retained.
- Added the error property to the granularRestoreArtifactBase resource and its derived types. Use this property to get error details when a granular restore operation for an individual artifact fails or completes with an error.
- Added audit metadata to the browseQueryResponseItem resource. Use this metadata to identify when a file or folder was created or last modified and who made the change when you select items for granular restore.
- Added support for tracking backup retention periods and pending retention changes on protectionUnitBase. Use the backupRetentionPeriodInDays and pendingRetentionPeriodChange properties to monitor protection units as they move between policies with different retention periods.
Identity and access | Directory management
- Added the isPrivileged property to the unifiedRoleDefinition resource type. Use it to identify roles that contain sensitive Microsoft Entra resource actions.
- Promoted the lifecycle relationship on user to v1.0 to read guest lifecycle and compliance information.
- Promoted the lifecycle relationship on servicePrincipal from beta to v1.0 to read agent identity lifecycle and compliance information. agentIdentity inherits this relationship.
- Promoted the user: attest, servicePrincipal: attest, and agentIdentity: attest methods from beta to v1.0 to attest to an identity's continued need.
- Promoted the addSelfAsSponsor and removeSelfAsSponsor methods on user from beta to v1.0 for self-service guest sponsorship.
Identity and access | Governance
- Promoted SAP Access Control (SAP AC) support for externalOriginResourceConnector from beta to v1.0. Use the
sapAcconnector type to configure connections to SAP AC systems for entitlement management. - Promoted lifecyclePolicy, agentIdentityLifecyclePolicy, and guestLifecyclePolicy from beta to v1.0 to manage policy-based governance of agent identities and guest users. Use the lifecyclePolicies and lifecyclePolicyPriorityConfigurations relationships on lifecycleWorkflowsContainer and the lifecyclePolicyPriorityConfiguration resource to manage policies and their evaluation order.
- Promoted the lifecyclePolicies relationship on deletedItemContainer and the lifecyclePolicy: restore method from beta to v1.0 to retrieve and restore soft-deleted policies.
- Promoted lifecyclePolicyRule, periodicAttestationRule, sponsorPresenceRule, inactivityRule, accessPackageAssignmentRequiredRule, and invitationRedemptionRule from beta to v1.0 to define lifecycle compliance requirements.
- Promoted the policy scope types selectedObjectsSubjectSet, allExcludingSpecificObjectsSubjectSet, allExcludingGroupsSubjectSet, selectedAgentBuilderPlatformsSubjectSet, and allExcludingAgentBuilderPlatformsSubjectSet from beta to v1.0.
- Promoted lifecyclePolicyEnforcementAction, deleteOnlyEnforcementAction, disableOnlyEnforcementAction, disableThenDeleteEnforcementAction, and lifecyclePolicyNotificationSettings from beta to v1.0 to configure enforcement and notifications.
- Promoted lifecyclePolicyReport, lifecyclePolicySubjectReport, lifecyclePolicyScopeProcessing, and lifecyclePolicyScopeProcessingAttempt from beta to v1.0 to report policy evaluation and processing outcomes.
- Promoted the report value types lifecyclePolicyReference, lifecyclePolicySubjectReference, lifecyclePolicyUserSubjectReference, lifecyclePolicyAgentIdentitySubjectReference, lifecyclePolicySubjectCompliance, and lifecyclePolicySubjectEnforcement from beta to v1.0.
- Promoted identityLifecycle, userIdentityLifecycle, agentIdentityLifecycle, complianceIssue, and attestationComplianceIssue from beta to v1.0 to read lifecycle state and compliance issues.
- Promoted the agentBuilderPlatforms, complianceState, lifecyclePolicyRelationship, lifecyclePolicyComplianceStatus, lifecyclePolicyEnforcementStatus, lifecyclePolicyScopeProcessingStatus, lifecyclePolicyScopeProcessingAttemptStatus, lifecyclePolicyEnforcementActionState, lifecyclePolicyNextEnforcementAction, and lifecyclePolicySource enumerations from beta to v1.0. Added the
agentIdentitymember to subjectType for agent policy priority configuration.
Identity and access | Identity and sign-in
- Added the lastUsedDateTime property to the authenticationMethod resource to retrieve the latest successful use when usage data is available. The value is best effort; a
nullor absent value doesn't mean that the method was never used.
- Updated national cloud availability in China operated by 21Vianet for the mailFolder: delta and message: delta methods. Use these methods to track incremental changes to mail folders and messages within a mail folder.
- Added the distributionList resource type and related methods for managing personal distribution lists in a user's mailbox. Use these APIs to create, read, update, and delete distribution lists, and add or remove members.
- Promoted the reportMessage method on the message resource from beta to v1.0. Use this method to report a message as junk, phishing, or not junk, which improves mail filtering.
Mailbox import and export
- Added the isHidden property to the mailboxFolder resource to identify hidden mailbox folders.
- Use the existing includeHiddenFolders query parameter for listing folders and listing child folders. Set it to
trueto include both hidden and nonhidden folders.
Security | Data security and compliance
- Applications can now supply one or more sensitivity labels with file content submitted to the processContent API by using the sensitivityLabels property of processContentMetadataBase.
- Added the
copyToClipboard,pasteFromClipboard,print, andaccessDebugToolsmembers to the userActivityType and userActivityTypes enumerations in v1.0. These enumerations are used by activityMetadata and policyScopeBase to represent activities evaluated against data protection policies. Use thePrefer: include-unknown-enum-membersrequest header to retrieve these values.
November 2026: New in preview only
Backup and recovery | Microsoft 365 backup and storage
- Added request guidance and examples for using retentionSettings when you create or update Exchange, OneDrive for Business, and SharePoint protection policies to configure how long backups are retained.
Device and app management | Cloud PC
- Added the retrieveFlexCloudPcAccessConfiguration and retrieveFlexCloudPcConfigurationDetail functions on the cloudPC resource to retrieve live Windows 365 Flex access state and Flex license availability.
- Added the
cloudPcReserveHealthScenariomember to the alertRuleTemplate enumeration type used by alertRule to monitor Windows 365 Reserve Cloud PC health conditions. - Added the
cloudPcReserveLicensesAvailabilityBelowThreshold,reserveCloudPcUnlicensedUsersAssignment, andcloudPcMaxUserStorageUsageThresholdExceededmembers to the conditionCategory enumeration type used by ruleCondition to monitor available Reserve licenses, unlicensed user assignments, and maximum user storage usage.
Identity and access | Directory management
- Added the isSingleInstance property to the application resource, inherited by agentIdentityBlueprint. Set it when creating a blueprint to support at most one active agent identity per tenant without an agent identity blueprint principal.
- Added the instanceMode property to the agentIdentity resource and the instanceMode enumeration to identify the single-instance or multi-instance topology.
- Devices now support soft-deletion and restoration. When a device is deleted, it's moved to the deleted items container and can be restored within 30 days. After 30 days, it's permanently deleted.
Identity and access | Governance
- Added three predefined tasks to the Lifecycle Workflows task catalog to send identity-verification links, request Verified ID presentation, and email verification status to a manager.
- Added the Pre-hire identity verification initiation (Preview) and New Hire employee onboarding with identity verification (Preview) Joiner templates to the Lifecycle Workflows template catalog.
Identity and access | Identity and sign-in
- Added the
aiElevatedAccountRiskmember to the riskDetail enumeration to indicate that the user completed Microsoft-managed remediation to address their risk. - Added the
userPassedVerifiedIdDrivenByRiskBasedPolicymember to the riskDetail enumeration to indicate that the user remediated their risk by completing Verified ID verification under a risk-based Conditional Access policy.
Identity and access | Network access
- Added the webFilteringPolicy resource type and related methods for configuring how Global Secure Access allows or blocks web traffic based on source sessions, URLs, web categories, and HTTP request methods.
Security
- Added the lookback property to the ruleSchedule resource to control the time window evaluated by each scheduled custom detection rule run.
- Added the eventGroupingKind property to the alertTemplate resource and the eventGroupingKind enumeration type. Use
singleAlertto group matching events from one scheduled execution into a single alert, oralertPerEventto create a separate alert for each matching event. - Added the resourceQuota resource type and the resourceQuotas property on the organization resource to let administrators monitor and configure quota allocations for resource types in their Microsoft Entra organization.
Security | Case management
- Removed support for the
$skipquery parameter in the case management APIs. Update affected requests to omit$skip.
Security | Content management
- Added support for connecting and managing source-control repositories that deploy security content as code by using the contentManagementRepository resource.
Security | Data security and compliance
Added the classificationGradingJobResponse resource type and classificationGradingContentLocation complex type to return matched text and surrounding context through the optional contextText property in classification grading results.
Teamwork and communications | Messaging
- Removed the
If-Matchheader from create section, update section, delete section, reorder sections, create section item, move section item, reorder section items, and delete section item methods of the teamworkSection and teamworkSectionItem resources. These operations now return a409 Conflictresponse code for concurrent changes, and no longer return412 Precondition Failedor428 Precondition Required. - Updated the add teamworkSectionItem method to move an item from another user-defined section.
- Added the teamworkChannelTag resource type and associated methods for managing tags owned by a Microsoft Teams channel. Use channel tags to group users within a channel and manage their tag assignments.
Tenants | Configuration management
- Added the configurationTemplate resource type and related methods to manage reusable, versioned baselines and reference them from monitors.
- Added the
applyOncemode to configurationMonitor. Use it to apply a desired-state baseline once on behalf of the signed-in administrator. - Added the remediate action to restore drifted resource properties to their baseline values and inspect the success or failure result.
October 2026: New and generally available
Applications
- Added the kerberosTicket property to the optionalClaims resource type to select group SID categories for Kerberos tickets. Use the configuring application's groupMembershipClaims setting to scope eligible memberships within those categories.
Backup and recovery | Microsoft 365 backup and storage
- Use the policyId property on the restoreSessionBase resource to scope restore sessions to a protection policy.
- Use the optional policyId parameter on the restorePoint: search method to validate protection-unit membership and improve policy-scoped routing. You can also filter the restore points collection by protectionUnit/policyId.
- Added the getStatisticsByPolicy method to the backupReport resource type in v1.0. Use it to retrieve policy-level protection statistics for Microsoft 365 Backup Storage.
Calendars
- Promoted the isSharedWithMe property of calendar resource from beta to v1.0. The property is used to identify the shared calendars.
- Added the delta method to the calendar resource type. Use it to track calendars added, deleted, or updated in a user's mailbox.
Calendars | Places
- Use the lastUpdatedTime and customProperties properties on the place resource to read when a place was last updated and manage custom string key-value metadata.
- The Place update API doesn't honor administrative roles assigned to groups in Microsoft Entra ID. Instead, assign the required role directly to the user in Microsoft Entra ID, or assign it to a user or group through the Microsoft 365 admin center.
Identity and access | Directory management
- Added the deletedDateTime property to the unifiedRoleDefinition resource. Use it to read when a custom role definition was soft-deleted.
Promoted the managerApplications property on the agentUser resource type from beta to v1.0. Use it to read the application IDs authorized to manage the agent user's backing agent blueprint. The property is read-only and is returned only when explicitly selected with the microsoft.graph.agentUser type cast.
Identity and access | Governance
- Added the timeBasedAttributeTriggerV2 resource type for configurable time-based lifecycle workflow triggers. Select a date-type user attribute and configure an operator to run workflows on an exact date, within a rolling window, or between two offsets before or after that date.
- Added the isEnabled property to the roleManagementCustomCalloutExtension resource type in v1.0. Use it to enable or disable a PIM custom extension without deleting it.
- Added the
applicationAuthorizationandappRolesmembers to the customExtensionResourceType enumeration in v1.0, extending the supported values of resourceType on roleManagementCustomCalloutExtension. Use thePrefer: include-unknown-enum-membersrequest header to retrieve these values. - Added the groupResource resource type and the resources relationship to the privilegedAccessGroup resource. Use them to list and get groups managed through Privileged Identity Management (PIM) for groups.
Identity and access | Identity and sign-in
- Added the federatedTokenValidationPolicy resource to control which federated domains Microsoft Entra ID accepts tokens from on a per-tenant basis, as a defense-in-depth measure against token-replay and rogue-IdP scenarios.
- Added support for routing SMS and voice authentication traffic through a telecom provider integration. Configure the provider endpoint, application identifier, evaluation mode, and migration percentage through the telecomProviderSettings property on the smsAuthenticationMethodConfiguration and voiceAuthenticationMethodConfiguration resources.
Mail | Message trace
Added support to identify recalled messages in message trace. Use recalled as a supported value of the status property of the exchangeMessageTrace resource.
Reports | Partner billing reports
Added the billedAggregatedUsage resource and related export method to the v1.0 endpoint. Cloud Solution Provider partners can use the export method to generate billed aggregated Azure usage reports for a specific invoice.
Security | Audit log query
Added 35 members, from PlannerCustomFieldDefinition through MESRawEmailContentMetadata, to the auditLogRecordType enumeration and added the matching auditData derived types to represent workload-specific audit event payloads.
Security | Custom detection rules
Added support for managing Microsoft Defender XDR custom detection rules in v1.0 through the detectionRule resource.
Tasks and plans
Added support for single-value extended properties on todoTask and todoTaskList resources, enabling apps to store and retrieve custom data for Microsoft To Do tasks and task lists.
Teamwork and communications | Calls and online meetings
Added the engagements property to the attendanceRecord resource. Use it to get real-time participant interaction behaviors that are captured as part of the attendance report, including reactions, hand raises, camera toggles, and microphone mute and unmute events.
Tenants | Cross-tenant migration
Added the cross-tenant migration API and related methods to the v1.0 endpoint. Use the API to create migration jobs, validate their configuration, migrate user data between Microsoft 365 tenants, monitor migration status, and cancel migration jobs or individual user tasks.
Tenants | Tenant governance
Added the refreshStatus method to get the status of the most recent related tenants refresh operation.
October 2026: New in preview only
Applications
Added the audit member to the appManagementRestrictionState enumeration type used by the appManagementPolicy resource. Use this value to evaluate application management policy restrictions without enforcing them.
Backup and recovery | Microsoft 365 backup and storage
- Track admin activities on backup and restore resources, including policy changes, dynamic rule executions, offboarding, and restore task completions, by using the activityLogBase resource and its derived types.
- Removed the tags property on the restoreTaskActivityLog in favor of the restoreJobType property. Use the restoreJobType property with values from the restoreJobType enumeration type.
- Added the backupPolicyDeleted member as a new supported value for the activityType property on the activityLogBase resource and its derived types.
Calendars | Places
The Place update API doesn't honor administrative roles assigned to groups in Microsoft Entra ID. Instead, assign the required role directly to the user in Microsoft Entra ID, or assign it to a user or group through the Microsoft 365 admin center.
Device and app management | Cloud PC
- Updated the date when deprecated image properties on cloudPcDeviceImage, cloudPcSourceDeviceImage, and cloudPcGalleryImage will stop returning data from January 31, 2024 to December 7, 2026. No replacement is planned for recommendedSku. Review the replacement property guidance in these resource topics and update affected integrations before the deadline.
- Added support for extending Windows 365 Reserve access for multiple users through the submitManagedLicenseOperation action on the cloudPcManagedLicense collection. Poll the submitted operation to check completion and inspect per-user results.
- Use the retrieveManagedLicenseOperation operation to retrieve the status and per-user results of a submitted operation.
- Added the setDeviceName action to set a Cloud PC's operating system device name without changing its display name.
- Added the cloudPcBulkSetDeviceName resource type to set device names for multiple Cloud PCs by using a naming template.
Device and app management | Device updates
- Added the driverUpdatePolicy, driverUpdateRing, and driverUpdateApprovalRule resource types to manage driver and firmware update approvals and deployments with Windows Autopatch.
- Added the featureUpdatePolicy and featureUpdateRing resource types to manage feature update deployments and gradual rollout settings with Windows Autopatch.
- Added the tenantSetting and mdmAppSetting resource types to manage tenant-level and MDM application settings for Windows Autopatch.
- Added the applicableCatalog and applicableDevice resource types to identify updates that apply to devices targeted by a Windows Autopatch policy.
- Added the updateData resource type and related device profile, policy assignment, catalog applicability, and driver reporting resources to retrieve Windows Autopatch deployment data.
Files
Updated the getSharePointApiUsage method to support SharePoint service prioritization reports. Use this report to retrieve total, standard, heavy, billed standard, and billed heavy API request counts by application and date.
Identity and access | Directory management
- Added the objectConnection resource type and related methods to inspect or clear cached connector data store linkage records.
- Added the objectConnections relationship to the synchronizationJob resource to access linkage records for known object identifiers.
Identity and access | Governance
- Added the accessDriftSummary resource type and related methods for identifying governed resources whose actual access differs from access-package intent. Use it to list and inspect drift summaries, retrieve drift details, and download bulk reconciliation reports. Access drift details identify whether each affected identity is a user or group through the identityType property of entraDriftIdentityInfo.
- Added methods to read and configure a user's approverDelegate. Use them to delegate approval of Microsoft Entra entitlement management access package assignment requests and access reviews to another user or group for a specified period of time. Users can manage their own delegate, and Identity Governance Administrators can manage the delegate of any user.
- Added the gracePeriodInDays property to the lifecyclePolicyRule resource. Use it to configure an optional grace period for each lifecycle policy rule before the policy action sequence starts.
- Added the roleManagementCustomCalloutExtension resource type and related methods for integrating external approval, ticketing, compliance, and audit workflows into Privileged Identity Management role assignment lifecycle events. Use these capabilities to associate custom extensions with role management policies, submit approval or denial results for Microsoft Entra role and group assignment requests, and optionally update assignment schedules.
Identity and access | Identity and sign-in
- Added public preview support for OnPasswordUpdate custom authentication extensions. Use the onPasswordUpdateCustomExtension resource to notify external systems after a self-service password reset and the onPasswordUpdateListener resource to configure when the notification occurs.
- Added the identityVerificationStatus resource type and related methods to read a user's verification status, record verification events, apply administrative override reasons, and remove event records.
- Added the provenance property to the authenticationMethod resource to inspect the trust classification, supporting assertions, and chain status of FIDO2 authentication methods. Added the attestProvenance action to apply an administrative attestation to credential provenance.
- Added support for routing SMS and voice authentication traffic through a telecom provider integration. Configure the provider endpoint, application identifier, evaluation mode, and migration percentage through the telecomProviderSettings property on the smsAuthenticationMethodConfiguration and voiceAuthenticationMethodConfiguration resources.
- Added the identityVerificationEventsConfiguration property to the verifiableCredentialsAuthenticationMethodConfiguration resource. Use it to control tenant-wide collection and exposure of identity verification events and credential provenance information for Verified ID verification.
- Added the conditionalAccessPolicyPlan resource type and related methods for grouping shared Conditional Access conditions with scenario-specific rules. Use policy plans to consolidate common targeting conditions and manage rule-specific enforcement controls.
- Added the settings relationship to the conditionalAccessRoot resource and related methods to read, update, and reset tenant-wide user-action exclusions for Conditional Access policies that target all resources.
Groups
Added the mailboxId property to the group resource type to identify the Exchange mailbox associated with a Microsoft 365 group. The property is returned only when specified in $select.
Identity and access | Directory management
Added the isHardDeleteProtectionEnabled property to the user (excluding on-premises synchronized users), group, application, and servicePrincipal resources. Enable hard deletion protection on existing objects to block permanent deletion for seven days after soft deletion. Once enabled, protection can't be disabled.
Added the importMime method to the mailFolder resource to create a non-draft message in a mail folder directly from MIME content. Unlike creating a message, which always creates a draft, this method creates the message in a final, non-draft state. The message appears in the destination folder as if it was delivered; however, it doesn't go through transport, isn't stamped as sent, and never appears in the Sent Items folder. The action preserves the full MIME content, including internet message headers, body parts, and attachments. Use the importMime API to import existing mail into a mailbox, such as to migrate messages from another system.
Mail | Message trace
Added support to identify recalled messages in message trace. Use recalled as a supported value of the status property of the exchangeMessageTrace resource.
Mailbox import and export
- Added the isHidden property to the mailboxFolder resource to identify hidden mailbox folders.
- Use the existing includeHiddenFolders query parameter for listing folders and listing child folders. Set it to
trueto include both hidden and nonhidden folders.
Reports | Identity and access reports
- Added the appManagementAudit resource type and related methods to retrieve Microsoft Entra application management audit logs. Use these APIs to understand how app management policy restrictions affected application and service principal changes.
- Added the
passwordUpdatemember to the eventType property of the appliedAuthenticationEventListener resource to identify OnPasswordUpdate custom extension listeners triggered during sign-ins. - Added methods to the serviceActivity resource to retrieve counts of successful and failed Agent ID autonomous and interactive sign-ins during a specified time period.
- Added the
notAppliedAllAppsExclusionandreportOnlyNotAppliedAllAppsExclusionmembers to the appliedConditionalAccessPolicyResult enumeration used by the result property of appliedConditionalAccessPolicy. Use these values to distinguish enabled and report-only policies skipped by an enabled all-apps exclusion from policies that don't apply for other reasons.
Security
Added the incidentConfiguration property to the detectionAction resource and the incidentConfiguration complex type. Use this setting to exclude alerts generated by a custom detection rule from automatic incident correlation and create standalone, single-alert incidents.
Security | Agentic security
- Added the agenticSecurityRoot resource and related methods to discover security playbooks, create and monitor investigation sessions, inspect agent progress, and download investigation reports.
Security | Audit log query
Added 35 members, from PlannerCustomFieldDefinition through MESRawEmailContentMetadata, to the auditLogRecordType enumeration and added the matching auditData derived types to represent workload-specific audit event payloads.
Security | Case management
Clarified the existing maximum length of the message property on the comment resource: 1,000 characters for incident cases and 5,000 characters for generic cases. These limits apply when you create a comment activity. The 5,000-character limit also applies when you update a comment activity in a generic case; the update of comment activities in incident cases remains unsupported.
Security | Data security and compliance
- Applications can now supply one or more sensitivity labels with file content submitted to the processContent API by using the sensitivityLabels property of processContentMetadataBase.
- Added the
unknownFutureValuemember to the applicationMode enumeration as a sentinel for future application modes. - Updated the evaluationErrorType enumeration to use customer-facing reasons for incomplete policy evaluations, and removed the errorMessage property from the evaluationErrorDetail complex type. Use errorType to identify why an evaluation couldn't be completed.
Security | Workbooks
Added the workbook resource type and related methods to manage tenant-scoped Microsoft Security workbook documents. Use stable IDs for repeatable deployments and replace a workbook's JSON content as a complete document.
Teamwork and communications | Messaging
- Added methods to get a custom emoji or its raw image content and delete a custom emoji by display name.
- Updated the teamworkCustomEmoji resource to inherit its identifier, binary content, content type, and media-stream behavior from teamworkHostedContent.
- Added support for setting and unsetting custom emoji reactions on chat messages by specifying a display name (displayName), service-issued identifier (reactionId), or both. For more information, see chatMessageReaction.
Contribute to Microsoft Graph
Are there scenarios you'd like Microsoft Graph to support?
Suggest and vote for new features by using the Microsoft Graph Feedback Portal. Some new features originate as popular requests from the developer community. The Microsoft Graph team regularly evaluates customer needs and releases new features to the beta (
https://graph.microsoft.com/beta) and v1.0 (https://graph.microsoft.com/v1.0) endpoints.Join the weekly Microsoft 365 platform community call and become an active member of the Microsoft Graph community. To discover the full calendar of developer calls, visit the Microsoft 365 and Power Platform community page.
Join our research panel to provide your input on our developer experiences.