Microsoft Graph REST API v1.0 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) are in general availability (GA) status, 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 do not break existing app scenarios.

Common use cases

The power of Microsoft Graph lies in easy navigation of entities and relationships across different services exposed on a single Microsoft Graph REST endpoint.

A number of these services are designed to enable rich scenarios around a user and around a group.

User-centric use cases in v1.0

  1. Get the profile and photo of a user, Lisa.
  2. Get the profile information about Lisa's manager and IDs of her direct reports, all stored in Azure Active Directory.
  3. Access Lisa's files on OneDrive for Business, find the identity of the last person who modified a file there, and navigate to that person's profile.
  4. Access Lisa's calendar on Exchange Online and determine the best time for Lisa to meet with her team in the next two weeks.
  5. Subscribe to and track changes in Lisa's calendar, tell Lisa when she is spending more than 80% of her time in meetings.
  6. Set automatic replies when Lisa is away from the office.
  7. Get the people who are most relevant to Lisa, based on communication, collaboration, and business relationships.
  8. Get the latest sales projection from a chart in an Excel file in Lisa's OneDrive for Business.
  9. Find the tasks assigned to Lisa in Planner.

Office 365 group use cases in v1.0

  1. Run a report on Office 365 groups in an organization and identify the group with the most communication among group members.
  2. Find the plans of this Office 365 group, and the assignment of tasks in that plan.
  3. Start a new conversation in the Office 365 group to determine if members want to create another group to share the workload.
  4. Get the default notebook for the group and create a page to note the outcome of the investigation.

Other API versions

There are currently 2 versions of Microsoft Graph REST APIs - 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. Be aware that APIs in preview status are subject to change, and may break existing scenarios without notice. Don't take a production dependency on APIs in the beta endpoint.

Find more information about versioning and support.

Connect with us

Are there additional APIs or features you'd like to see in Microsoft Graph? Post new feature requests on UserVoice.

Have feedback for existing Microsoft Graph APIs? Connect with us on Github.

For questions or help with your code using Microsof