Microsoft 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.

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.

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

User-centric use cases in v1.0

Microsoft 365 group use cases in v1.0

Call the v1.0 endpoint

Microsoft Graph API requests to the v1.0 endpoint use the following pattern:

https://graph.microsoft.com/v1.0/{resource}?[query_parameters]

For more information about Microsoft Graph REST API calls, see Use the Microsoft Graph API.

Microsoft Graph beta endpoint

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.

What's new

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.