Events
17 Mar, 9 pm - 21 Mar, 10 am
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowMicrosoft Graph REST API v1.0 endpoint reference
Welcome to Microsoft Graph REST API reference for the v1.0 endpoint.
API sets on the v1.0 endpoint (https://graph.microsoft.com/v1.0) have reached general availability (GA), and have gone through a rigorous review-and-feedback process with customers to meet practical, production needs. Updates to APIs on this endpoint are additive in nature and don't break existing app scenarios.
The power of Microsoft Graph lies in easy navigation of entities and relationships across different services exposed on a single Microsoft Graph REST endpoint.
Some of these services are designed to enable rich scenarios around a user and around a group.
- Get the profile and photo of a user.
- Get the profile information for a user's manager and IDs of their direct reports, all stored in Microsoft Entra ID.
- Access a user's files on OneDrive, find the identity of the last person who modified a file there, and go to that person's profile.
- Access a user's calendar on Exchange Online and determine the best time to meet with their team in the next two weeks.
- Subscribe to and track changes in a user's calendar, and tell the user when they're spending more than 80% of their time in meetings.
- Set automatic replies when a user is away from the office.
- Get the people who are most relevant to a user, based on communication, collaboration, and business relationships.
- Get the latest sales projection from a chart in an Excel file in a user's OneDrive.
- Find the tasks assigned to a user in Planner.
- Run a report on Microsoft 365 groups in an organization and identify the group with the most communication among group members.
- Find the plans of this Microsoft 365 group, and the assignment of tasks in that plan.
- Start a new conversation in the Microsoft 365 group to determine if members want to create another group to share the workload.
- Get the default notebook for the group and create a page to note the outcome of the investigation.
Microsoft Graph API requests to the v1.0 endpoint use the following pattern:
HTTP
https://graph.microsoft.com/v1.0/{resource}?[query_parameters]
For more information about Microsoft Graph REST API calls, see Use the Microsoft Graph API.
Currently, two versions of Microsoft Graph REST APIs are available: v1.0 and beta.
If you're interested in new or enhanced APIs that are still in preview status, see Microsoft Graph beta endpoint reference.
Caution
APIs in preview status are subject to change, and might break existing scenarios without notice. Don't take a production dependency on APIs in the beta endpoint.
For more information, see Versioning and support.
Find out what's new in the v1.0 endpoint.
For details about changes to Microsoft Graph APIs in v1.0, explore the API changelog.
Additional resources
Training
Certification
Microsoft 365 Certified: Endpoint Administrator Associate - Certifications
Plan and execute an endpoint deployment strategy, using essential elements of modern management, co-management approaches, and Microsoft Intune integration.
Documentation
-
Use Graph Explorer to try Microsoft Graph APIs - Microsoft Graph
Try Microsoft Graph APIs on the default sample tenant to explore capabilities, or sign in to your tenant and use it as a prototyping tool to fulfill your app scenarios.
-
Calling the Microsoft Graph API - Microsoft Graph
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 API - Microsoft Graph
Learn how to register your app and get authentication tokens for a user or service before you make requests to the Microsoft Graph API.