Microsoft graph api reference. Jul 23, 2025 · Namespace: microsoft.
Microsoft graph api reference Contact Microsoft Support. You can update the mail via the Update user API, but can't update proxyAddresses through Microsoft Graph. The data can be calendar, mail, or personal contacts stored in a mailbox in the cloud on Exchange Online as part of Microsoft 365, or on Exchange on-premises in a hybrid deployment. For more information about relationships between group, plan, and task, See Use the Planner REST API. You can also configure the app manifest through the Microsoft Entra admin center. graph Create a new group as specified in the request body. Jan 17, 2025 · The education API in Microsoft Graph enhances Microsoft 365 resources with information that is relevant for education scenarios, including information about schools, classes, users (students and teachers), assignments, and submissions. For SharePoint Online, innovation using a REST API against SharePoint is driven via the Microsoft Graph REST API's. Contribute to Azure/microsoft-graph-docs development by creating an account on GitHub. Learn how to use the $filter OData query parameter and its operators to filter a collection of resources in Microsoft Graph. Featuring the latest software updates and drivers for Windows, Office, Xbox and more. Read permission in addition to Application. The authentication provider handles acquiring access tokens for the application. Both mail and proxyAddresses can be retrieved through the GET user API. graph Represents an instance of an application in a directory. Chapter 3. Nov 7, 2024 · Find instructions for installing the Microsoft Graph SDKs for . Those APIs will enable you to automate workflows and innovate based on Defender for Endpoint capabilities. Sep 30, 2024 · With Microsoft Graph, you can access Microsoft 365 usage reports resources to get the information about how people in your business are using Microsoft 365 services. The Microsoft Graph security API provides a unified interface and schema to integrate with security solutions from Microsoft and ecosystem partners. graph. It's a place where employees can connect with leaders, coworkers, and communities, share their knowledge and ideas, and find belonging at work. It empowers customers to streamline security operations and better defend against increasing cyber threats. Nov 17, 2025 · Learn how to make successful calls in the Exchange Online Admin API. Contacts are contained in contact folders. User permissions to your app. Aug 21, 2025 · Namespace: microsoft. Microsoft Graph allows you to manage resources in your Azure AD B2C directory. View the top Planner API tasks. To get started, see Use the Microsoft Graph security API. Nov 7, 2024 · Use the Outlook mail API in Microsoft Graph to manage contacts, schedule meetings, initiate online conversations, share files, and collaborate in groups. This resource supports: Adding your own data to custom properties as extensions. Sep 25, 2024 · The Microsoft Graph API for Intune enables programmatic access to Intune information for your tenant; the API performs the same Intune operations as those available through the Azure Portal. Nov 7, 2024 · Use the Microsoft Graph security API to connect Microsoft security products, services, and partners to streamline security operations and improve response capabilities. To skip directly to the API reference, see Microsoft Graph APIs for Microsoft Entra features. graph Update the properties of a group object. In the Microsoft 365 platform, three main components facilitate the access and flow of data: The Microsoft Graph API offers a single endpoint, https://graph. Mar 5, 2025 · Namespace: microsoft. User and ProtectionScopes. graph Represents a device registered in the organization. In this guide, Microsoft MVP, Todd Klindt breaks down its evolution, permissions, and essential tools to help you get started. graph Get the properties and relationships of a device object. With the new version switcher above the table of contents, you can now quickly switch between the v1. To create a new instance of this class, you need to provide an instance of IAuthenticationProvider which can authenticate requests to Microsoft Graph. For example, you can identify who is using a service a lot and reaching quotas, or who may not need a Microsoft 365 license at all. Read. Tasks are organized in task lists accessed across To Do clients, Outlook, and Teams. It's protected by the Microsoft identity platform, which authorizes and verifies that an app is authorized to call Microsoft Graph. All calls to the OneNote service through the Microsoft Graph API use this service root URL: Oct 1, 2024 · Namespace: microsoft. NET, Go, Java, JavaScript, PHP, PowerShell, and Python. NET Client Library is made up of 6 major components: A client object An authentication provider An HTTP provider + serializer Request builder objects Request objects Property bag object model classes for serialization and deserialization The library is designed to be highly extensible. When using MIME format: Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body. Jun 28, 2024 · Namespace: microsoft. Use Microsoft Graph REST APIs and SDKs to accelerate Microsoft 365 app development. Use a higher privileged permission or permissions only if your app requires it. This overview covers basic scenarios but many of the individual components can be Microsoft Graph quick start Build a sample app that connects to Microsoft 365 and calls the Microsoft Graph API. This article explains how to access and manage user data using Microsoft Graph, including common API operations, authorization Dec 31, 2024 · Access audit logs using Microsoft Graph APIs to track user activity in a Microsoft Entra tenant, integrate with third-party SIEM tools, and remain compliant. This resource is an open type that allows other properties to be passed in. Save documents, spreadsheets, and presentations online, in OneDrive. May 16, 2024 · The reference content in this section documents the Microsoft Graph REST APIs in the beta endpoint. You can use REST APIs or SDKs to access the endpoint and build apps Oct 25, 2024 · API documentation for integration with Microsoft GraphIn this section, you can find API documentation for Microsoft Graph. Sep 17, 2025 · Microsoft Graph is a unified API that enables developers to access and integrate data from Microsoft 365 services, delivering a seamless user experience. The beta endpoint includes APIs that are currently in preview and aren't yet generally available. Discover the power of Microsoft Graph and learn how to use it to access data and intelligence from Microsoft services. Compute. 0 of Microsoft Graph. 6 days ago · Microsoft said Tuesday it is partnering with artificial intelligence company Anthropic and chipmaker Nvidia as part of a cloud infrastructure deal that moves the software giant further away from Access and manage your Microsoft account, subscriptions, and settings all in one place. 0 and beta reference content. In scenarios where solutions already have access tokens available to access SharePoint content, it's possible to access the REST API natively within Namespace: microsoft. May 16, 2024 · Find reference content for the Microsoft Graph REST APIs in the beta endpoint, which includes APIs that are currently in preview and aren't yet generally available. Microsoft Graph API documentation is an invaluable resource for developers looking to harness the power of Microsoft’s ecosystem. Use Microsoft Graph to use a single API to work with these files. Items in SharePoint document libraries can be represented as listItem or driveItem resources. To see the full list of permissions that Microsoft Graph exposes, see the Microsoft Graph permissions reference. Nov 7, 2024 · Use the Planner API in Microsoft Graph to create plans, organize and assign tasks, share progress, and collaborate on content. The cmdlet reference content is also autogenerated from the API reference. The official Microsoft Download Center. Watch this video for a quick overview of Defender for Endpoint's APIs. Jul 23, 2024 · Namespace: microsoft. Find solutions to common problems, or get help from a support agent. May 7, 2022 · The Microsoft Graph API reference documentation is the best place to check what operations are currently available and how to use them. Nov 7, 2024 · You can use the Intune API in Microsoft Graph to access Intune device and application information, manage devices, manage apps, and automate Intune. Nov 7, 2024 · Apply these best practices to improve your Microsoft Graph application's performance and make your app more reliable for end users. Inherits from directoryObject. Sign in to manage your account. Learn how to manage your users' authentication methods and get users registered to do multifactor authentication (MFA) and self-service password reset (SSPR). Jan 30, 2025 · Learn about Microsoft Graph national cloud deployments and the capabilities that are available to developers within each. These devices can range from desktop and laptop machines to phones and tablets. graph Retrieve the properties and relationships of a servicePrincipal object. For more detailed API-level updates, see the Microsoft Graph API changelog. Microsoft Support is here to help you with Microsoft products. Dec 14, 2024 · For information about how to add and install the Microsoft Graph client package into your project, see Install the SDK. However, some attributes need to be configured by editing the app manifest directly in Jul 23, 2025 · Namespace: microsoft. 0 authentication. Jul 21, 2025 · Microsoft 365 Copilot connectors provide a platform for you to ingest your unstructured, line-of-business data into Microsoft Graph, so that Microsoft 365 Copilot can reason over the entirety of your enterprise content. Most attributes can be configured using a UI element in App registrations. 4 days ago · Microsoft Graph provides a unified programmability model that you can use to access data in Microsoft 365, Windows, and Enterprise Mobility + Security. Collaborate for free with online versions of Microsoft Word, PowerPoint, Excel, and OneNote. This document and the associated pattern catalog provide a refined set of guidance targeted specifically for Microsoft Graph services. Subscribing to change notifications. Any application that outsources authentication to Microsoft Entra ID must be registered in the Microsoft identity platform. Microsoft was founded on April 4, 1975, by Bill Gates and Paul Allen in Albuquerque, New Mexico. graph Represents an application. Nov 7, 2024 · Using the same unified Microsoft Graph REST endpoint, you can access the Bookings API and integrate with the best of Microsoft 365 to support richer scenarios. Nov 28, 2018 · Wherever you are on the Microsoft Graph site, you can click the API Reference link in the top navigation. All. Mar 29, 2023 · Find in-depth developer documentation for Exchange Server, including Exchange Online as part of Office 365 and Exchange Server on-premises versions. Namespace: microsoft. Sep 25, 2025 · The process for calling Graph APIs to access and retrieve transcripts and recordings remains the same for both meeting-specific RSC application permissions and organization-wide application permissions. No more juggling separate APIs—Graph simplifies access, automation, and insights. Mar 18, 2025 · Microsoft Graph lets you build compelling app experiences based on users and their relationships with other objects, such as other users and groups, group memberships, and the resources they access like their emails, calendars, files, and administrative roles. The list of events contains single instance meetings and series masters. Oct 26, 2024 · Namespace: microsoft. We invite you to try these APIs and provide your feedback. graph List all the groups available in an organization, excluding dynamic distribution groups. To get properties that are not returned by default, do a GET operation and If you would like to configure Microsoft Graph App Manifest programmatically, you can either use Microsoft Graph API or Microsoft Graph PowerShell SDK. Microsoft is a multinational computer technology corporation. This API is available in the following national cloud deployments. After you register your app and get authentication tokens for a user or service, you can make requests to the Microsoft Graph API. 6 days ago · Use Microsoft Entra Agent ID APIs in Microsoft Graph to create, secure, and monitor AI agent identities. Jan 13, 2025 · It will help administer every Microsoft Entra feature that has an API in Microsoft Graph. Oct 31, 2023 · Learn what the Microsoft Graph Services API is and where to go for more information. Guidance for Microsoft Graph service teams Graph service teams should reference the companion document, Microsoft Graph REST API Guidelines when building or modifying their services. An instance of the GraphServiceClient class handles building requests, sending them to Microsoft Graph API, and processing the responses. You can create the following types of groups: Microsoft 365 group (unified group) Security group This operation returns by default only a subset of the properties for each group. For example, you can assign the Content. Collaborate for free with online versions of Microsoft Word, PowerPoint, Excel, and OneNote. This resource represents potential security issues within a customer's tenant that Microsoft 365 Defender, or a security provider integrated with Microsoft 365 Defender, identified. This resource supports using delta query to track incremental additions, deletions, and updates, by providing a delta function. Nov 7, 2024 · Use the SharePoint REST API in Microsoft Graph to integrate solutions with SharePoint sites and content that users collaborate on and share across an organization. 0 Authorization Code Flow. Operating systems include Windows, Mac, Linux, iOS, and Android. Contribute to microsoftgraph/microsoft-graph-docs-contrib development by creating an account on GitHub. Nov 7, 2024 · Use OneDrive, the files hub in Microsoft 365, to access files no matter where they are stored. graph The driveItem resource represents a file, folder, or other item stored in a drive. Microsoft Graph is a RESTful web API that enables you to access Microsoft Cloud service resources. Oct 22, 2025 · The Microsoft Graph API enables apps to manage communities and roles in Viva Engage. graph Microsoft Entra entitlement management can help you manage access to groups, applications, and SharePoint Online sites for internal users as well as users outside your organization. Dec 23, 2024 · Microsoft Graph is a protected API gateway for accessing data in Microsoft cloud services like Microsoft Entra ID and Microsoft 365. Nov 7, 2024 · You can use the Excel REST API in Microsoft Graph to extend the value of your Excel data, calculations, reporting, and dashboards. graph Get all provisioning events that occurred in your tenant, such as the deletion of a group in a target application or the creation of a user when provisioning user accounts from your HR system. Nov 7, 2024 · API reference Looking for the API reference for this service? Microsoft Purview Information Protection API in Microsoft Graph beta Microsoft Graph lets you build compelling app experiences based on users and their relationships with other objects, such as other users and groups, group memberships, and the resources they access like their emails, calendars, files, and administrative roles. Note: This request might have replication delays for users that were recently created, updated, or deleted. Find how-to articles, videos, and training for Microsoft Copilot, Microsoft 365, Windows 11, Surface, and more. For more information, see Microsoft Graph permissions reference and Authorize applications, resources, and workloads with Microsoft Entra ID. To get expanded event instances, you can get the calendar view, or get the instances of an event. The mail property is used as the user's email address for various purposes including user sign-in and defines the primary proxy address. Find reference content for the Microsoft Graph REST APIs in the beta endpoint, which includes APIs that are currently in preview and aren't yet generally available. This makes it easy for you to build solutions that integrate with educational resources for various school and classroom scenarios. Get started with Microsoft Graph documentation from Microsoft Graph exclusively on the Postman API Network. If you want to try the latest Microsoft Graph APIs, try the beta SDK. For more information, see OAuth 2. All file system objects in OneDrive and SharePoint are returned as driveItem resources. graph Retrieve a list of user objects. The EndpointsPerSegment directory contains a list of all the root segments of the Microsoft Graph API. Using delta query to track incremental additions, deletions, and updates Important Azure AD Graph API functionality is also available through Microsoft Graph, a unified API that also includes APIs from other Microsoft services like Outlook, OneDrive, OneNote, Planner, and Office Graph, all accessed through a single endpoint with a single access token. graph Retrieve a list of events in a calendar. User. List properties and relationships of the managedDevice objects. This operation returns by default only a subset of the properties for each group. Viva Engage is a social fabric for the Microsoft Viva suite of apps that connects people across the organization to share and learn. A Planner task is contained in a plan and can be assigned to a bucket in a plan. All or Application. For example, you can use Excel to track and analyze business financial data, and generate professional reports, or use SharePoint or Microsoft Teams to enhance team collaboration. The following code examples show how to create an instance of a Microsoft Graph client with an authentication provider in the supported languages. graph Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant. Process. What is "$ref"? Also what is the ReferencesRequest prefix in the . graph Returns the metadata for a list. graph Create an online meeting on behalf of a user. These REST APIs are a part of the Microsoft Graph, a common API for Microsoft services. ReadWrite. graph Retrieve the properties and relationships of a notebook object. Have your tenant admin configure Microsoft Purview policies and settings. The following Microsoft Graph API operations are supported for the management of Azure AD B2C resources, including users, identity providers, user flows, custom policies, and policy keys. By providing comprehensive information on API endpoints, authentication, and best practices, the documentation enables developers to create robust and integrated applications. Provides instructions for creating Microsoft Graph HTTP requests using the SDKs. Read). Application registration involves telling Microsoft Entra ID about your application, including the URL where it's located, the URL to send replies after authentication, the URI to identify your application, and more In some cases, access to data through Microsoft Graph APIs might require both Microsoft Graph permissions and RBAC permissions. To list applications owned by a specific personal Microsoft account, this API requires the User. This article provides an overview of the requirements for an app to be authorized to access data via any Microsoft Graph API. For performance reasons, the create, get, and list operations return only a subset of more commonly used properties by default. These default properties are noted in the Properties Use the OneNote API in Microsoft Graph to access OneNote notebooks, sections, and pages to create solutions that help your users plan and organize ideas and information. 3 days ago · SEATTLE, WA — The Microsoft Corporation announced today that they've developed a convenient new 47-factor authentication protocol for all Windows-enabled computers. What is missing in Mar 6, 2024 · The sophistication of security threats continues to escalate, affecting the global economy. Unified endpoint for accessing data, relationships and insights coming from the Microsoft cloud - Microsoft Graph Sep 18, 2024 · The Microsoft Graph security API provides a unified interface and schema to integrate with security solutions from Microsoft and ecosystem partners. The notion of organizations doesn't exist for personal Microsoft accounts. Discover how to use query parameters with Microsoft Graph APIs to control data retrieval and efficiently customize API responses and improve performance. Mar 6, 2024 · The Microsoft Graph API supports accessing data in users' primary mailboxes and in shared mailboxes. Jan 23, 2023 · The Outlook REST APIs are a part of Microsoft Graph. Jul 23, 2025 · Note When calling this API using tokens issued for a personal Microsoft account, it will return the apps owned by the personal Microsoft account. This article provides information about what's new in Microsoft Graph APIs, documentation, SDKs, and more. When using JSON format, you can include a file attachment in the same sendMail action call. Jun 29, 2022 · If you are looking for the legacy SharePoint REST API documentation, see Complete basic operations using SharePoint REST endpoints. The operations are presented in a tree hierarchy, organized by the entities and services. The docs are an awesome resource geared towards developers and lets you navigate by APIs and view the permissions required and includes code samples. Microsoft Teams is a chat-based workspace in Microsoft 365 that provides built-in access to team-specific calendars, files, OneNote notes, Planner plans, Shifts schedules, and more. Dec 23, 2024 · Use Microsoft Graph to access the relationships, documents, contacts, and preferences that are contextually relevant to users in your organization. Discover advanced automation, reporting, and identity management capabilities with Microsoft Graph PowerShell, including migration guidance and troubleshooting resources. If To access and manipulate a Microsoft Graph resource, you call and specify the resource URLs using one of the following operations: Use the Microsoft Graph REST API to build apps that access, analyze, and augment data from Microsoft 365. Namespace: microsoft. You can use the Microsoft Graph API to integrate with Microsoft Teams features. [1] Its current best-selling products are the Microsoft Windows operating system; Microsoft Office, a suite of productivity software; Xbox, a line of entertainment of games, music, and video; Bing, a line of search engines; and Microsoft It’s all here with Microsoft account Your Microsoft account connects all your Microsoft apps and services. Each task object has a details object that can contain more information about the task. . graph Represents a Planner task in Microsoft 365. Mar 6, 2024 · You can use the Planner API in Microsoft Graph to create tasks and assign them to users in a group in Microsoft 365. Add any attachments and S/MIME properties to the You can use Microsoft Graph to create an app that connects with files across OneDrive, OneDrive for Business, and SharePoint document libraries. Use the Microsoft Graph APIs to automate identity and access management tasks and integrate with any application. To retrieve dynamic distribution groups, use the Exchange admin center. graph Send the message specified in the request body using either JSON or MIME format. This article introduces Microsoft Graph permissions and provides guidance for using them. By creating access packages with the roles users need to have across those resources, and defining policies for who can request an access package and how long they can have an assignment Namespace: microsoft. These default properties are noted in the Properties section. Sep 17, 2021 · Graph Permissions Explorer 1 minute read If you are a developer in the Microsoft 365 ecosystem you will be well versed with the Microsoft Graph API reference docs and most probably know about permission scopes (eg. Documentation for the Microsoft Graph REST API. The calendar can be one for a user, or the default calendar of a Microsoft 365 group. Note: This SDK allows you to build applications using the v1. There are two primary ways of addressing a driveItem resource: By the driveItem unique identifier using Namespace: microsoft. Query data that Microsoft Search indexes and include custom external data. Apr 3, 2024 · Represents the entry point for OneNote resources. This article explains how to access and manage user data using Microsoft Graph, including common API operations, authorization The Microsoft Graph . Apr 25, 2025 · Overview of Microsoft Defender XDR APIs Applies to: Microsoft Defender XDR Note The Microsoft Graph security API is a unified schema and interface that integrates with various Microsoft security solutions and Microsoft security partners. Dec 20, 2022 · Namespace: microsoft. microsoft. Sep 29, 2025 · Defender for Endpoint exposes much of its data and actions through a set of programmatic APIs. Feb 19, 2019 · Reading through the Microsoft Graph REST API documentation, and I see URL paths ending in "$ref", for example The Add Member Example here. Apr 22, 2025 · The reports API in Microsoft Graph enables you to understand application and resource activity in your Microsoft Entra tenant. Damage is often done long before organizations even discover it. May 2, 2023 · Documentation for the Microsoft Graph REST API. Try the toolkit to integrate common experiences into your app quickly. Nov 7, 2024 · Use the Microsoft Search API in Microsoft Graph to extend Microsoft Search to your apps. To learn more about these permissions, see the permissions reference. Inherits from List of all Microsoft Graph API endpoints currently available (that I could reverse engineer) in json format and markdown tables. Apr 26, 2025 · The Microsoft Entra family of identity and network access solutions helps you protect any identity and secure access to any resource. Microsoft Graph API reference This chapter introduces the Microsoft Graph API and provides a practical reference about how to consume it from any device and any - Selection from Programming Microsoft Office 365: Covers Microsoft Graph, Office 365 applications, SharePoint Add-ins, Office 365 Groups, and more [Book] Microsoft Graph API specs, API docs, OpenAPI support, SDKs, GraphQL, developer docs, CLI, IDE plugins, API pricing, developer experience, authentication, and API styles. graph Represents the entry point for OneNote resources. Nov 4, 2025 · Namespace: microsoft. The Microsoft Graph REST API Guidelines consist of a concise overview document, a collection of articles on Graph standards, and a library of patterns that provide best practices for resolving common API design problems. Devices are created in the cloud using the Device Registration Service or by Intune. For details about delegated and application permissions, see Permission types. graph The itemReference resource provides information necessary to address a driveItem or a listItem via the API. graph Represents a Microsoft Entra group, a Microsoft 365 group, or a security group. When a security provider detects a threat, it creates an alert in the To make things a bit easier, this post will serve as a reference guide on how to construct Graph calls so you can easily revisit it throughout your Graph adventures. The commands in Microsoft Graph PowerShell are autogenerated from the Microsoft Graph API schema making it easier to get faster updates and functionality. Aug 29, 2025 · Use the Microsoft To Do API in Microsoft Graph to manage tasks and plan your day. The REST API is shared between OneDrive, OneDrive for Business, SharePoint document libraries, and Office Groups, to allow your app the flexibility to read and store content in any of these locations with the same code. net sdk? Namespace: microsoft. Microsoft recommends using Microsoft Graph to access Outlook mail, calendar, and contacts. com, to provide access to rich, people-centric data and insights in the Microsoft cloud, including Microsoft 365, Windows, and Enterprise Mobility + Security. You can use Microsoft Graph to build or extend security solutions that consolidate and correlate security alerts from multiple sources, detect threats that attempt to compromise user identity, unlock contextual data to inform Namespace: microsoft. Each link in the following sections targets the corresponding page within the Microsoft Graph API reference for that operation. Feb 19, 2025 · Microsoft Graph is the key to seamless integration with Microsoft 365, connecting services like Teams, SharePoint, and OneDrive through a unified API. The API access requires OAuth2. security This resource corresponds to the most recent batch of alerts generated by the Microsoft Graph security API. graph A contact is an item in Outlook where you can organize and save information about the people and organizations you communicate with. Each segment contains a list of all the endpoints that are Get started with the Microsoft Graph SDK for Python by integrating the Microsoft Graph API into your Python application. You can use the how to, get started, new feature, and API reference documentation to develop tools to access and manage mailbox data from services, websites, desktop computers, and mobile devices, and to create custom solutions for email, calendar Choose the permission or permissions marked as least privileged for this API. ’s top executives is warning that state proposals for higher taxes risk devastating the region’s economy. graph Get the collection of items in a list. They're used by conditional access policies for multi-factor authentication. As job cuts spread gloom through the Seattle-area tech scene, one of Microsoft Corp. spyhamwe alavqc zjilgv rftmc wsxrvz sxd ymflpys dkgnfq jfjm rbuz jzvoy xarr kletuq ztjfov cusj