Microsoft Graph: Users and profiles
Read and update the signed-in user and other users: profile, photo, manager and direct reports, group memberships, licences, authentication methods, settings…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Read and update the signed-in user and other users: profile, photo, manager and direct reports, group memberships, licences, authentication methods, settings and insights.
This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 346 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.
Get an access token
- Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
- Under API permissions, add the Microsoft Graph permissions this area needs, for example:
User.Read,User.ReadBasic.All,User.ReadWrite.All,Directory.Read.All. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent. - Under Certificates & secrets, create a client secret (keep it out of shared collections).
- Get a token from
https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, orgrant_type=client_credentialswithscope=https://graph.microsoft.com/.defaultfor an app. Send it asAuthorization: Bearer.
Using these requests
- Base URL:
https://graph.microsoft.com/v1.0./me/...paths act on the signed-in user; with an application token use/users/{id or userPrincipalName}/...instead. - Shape responses with OData query parameters:
$select(fields),$filter,$orderby,$top,$expandand$search(some need theConsistencyLevel: eventualheader). Long lists are paged: follow@odata.nextLink. - Combine up to 20 requests in one call with
POST /$batch.
Common errors
| Status | Code | What to do |
|---|---|---|
| 401 | InvalidAuthenticationToken | The token is missing, expired or for another resource: get a new one for https://graph.microsoft.com. |
| 403 | Authorization_RequestDenied / ErrorAccessDenied | Add the permission listed in the request's docs and grant consent. |
| 404 | ResourceNotFound / itemNotFound | Check the id; ids from another user or tenant are not found. |
| 429 | TooManyRequests | Throttled: wait the Retry-After seconds, then retry. |
Docs: Users and profiles overview · Permissions reference · Throttling
Endpoints 346
Me
- GETGet me
/meRetrieve the properties and relationships of user object. This operation returns by default only a subset of the more commonly used properties for each user.… - PATCHUpdate me
/meUpdate the properties of a user object. To use this API to update an agentUser, specify an @odata.type property with a value of #microsoft.graph.agentUser in…
Notes
- GETList notes
/me/notesGet a list of the note objects in the user's *Notes* folder. - POSTCreate note
/me/notesCreate a new note in the user's *Notes* folder. - GETTrack changes to notes (delta)
/me/notes/delta()Get a set of note objects that were added, updated, or deleted in the user's *Notes* folder since the last delta query. A delta function call for notes is… - GETGet note
/me/notes/:note-idThe notes in the user's Notes folder. Read-only. Nullable. - DELETEDelete note
/me/notes/:note-id - PATCHUpdate note
/me/notes/:note-id
Photo
- GETGet photo
/me/photoGet the specified profilePhoto or its metadata (profilePhoto properties). The supported sizes of HD photos on Microsoft 365 are as follows: 48x48, 64x64,… - DELETEDelete photo
/me/photoDelete the photo for the signed-in user or the specified group. - PATCHUpdate photo
/me/photoUpdate the photo for the specified contact, group, team, or user in a tenant. The size of the photo you can update to is limited to 4 MB. You can use either… - GETDownload content
/me/photo/$valueGet the specified profilePhoto or its metadata (profilePhoto properties). The supported sizes of HD photos on Microsoft 365 are as follows: 48x48, 64x64,… - PUTUpload content
/me/photo/$valueUpdate the photo for the specified contact, group, team, or user in a tenant. The size of the photo you can update to is limited to 4 MB. You can use either… - DELETEUpload content
/me/photo/$valueDelete the photo for the signed-in user or the specified group.
Photos
- GETList photos
/me/photosThe collection of the user's profile photos in different sizes. Read-only. - GETGet photo
/me/photos/:profilePhoto-idThe collection of the user's profile photos in different sizes. Read-only. - GETDownload content
/me/photos/:profilePhoto-id/$valueThe unique identifier for an entity. Read-only. - PUTUpload content
/me/photos/:profilePhoto-id/$valueThe unique identifier for an entity. Read-only. - DELETEUpload content
/me/photos/:profilePhoto-id/$valueThe unique identifier for an entity. Read-only.
Manager
- GETGet manager
/me/managerThe user or contact that is this user's manager. Read-only. Supports $expand. - GETList references
/me/manager/$refThe user or contact that is this user's manager. Read-only. Supports $expand. - PUTSet
/me/manager/$ref - DELETERemove reference
/me/manager/$ref
Actions and more
- POSTRestore
/me/restoreRestore a recently deleted directory object from deleted items. The following types are supported: administrativeUnit application agentIdentityBlueprint… - POSTAssign license
/me/assignLicenseAdd or remove licenses for the user to enable or disable their use of Microsoft cloud offerings that the company has licenses to. For example, an organization… - POSTChange password
/me/changePasswordUpdate the signed-in user's password. Any user can update their password without belonging to any administrator role. To update another user's password in… - POSTGet member groups
/me/getMemberGroupsReturn all the group IDs for the groups that the specified user, group, service principal, organizational contact, device, or directory object is a member of.… - POSTGet member objects
/me/getMemberObjectsReturn all IDs for the groups, administrative units, and directory roles that an object of one of the following types is a member of: user group service… - POSTCheck member groups
/me/checkMemberGroupsCheck for membership in a specified list of group IDs, and return from that list the IDs of groups where a specified object is a member. The specified object… - POSTCheck member objects
/me/checkMemberObjectsCheck for membership in a list of group IDs, administrative unit IDs, or directory role IDs, for the IDs of the specified user group service principal… - POSTExport personal data
/me/exportPersonalDataSubmit a data policy operation request from a company administrator or an application to export an organizational user's data. This data includes the user's… - POSTRevoke sign in sessions
/me/revokeSignInSessionsInvalidates all the refresh tokens issued to applications for a user (and session cookies in a user's browser), by resetting the… - GETGet managed app policies
/me/getManagedAppPolicies()Gets app restrictions for a given user. - POSTRetry service provisioning
/me/retryServiceProvisioningRetry the provisioning of a user object in Microsoft Entra ID. - GETList service provisioning errors
/me/serviceProvisioningErrorsErrors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object. Supports… - POSTCreate reprocess license assignment
/me/reprocessLicenseAssignmentReprocess all group-based license assignments for the user. To learn more about group-based licensing, see What is group-based licensing in Microsoft Entra… - POSTRemove all devices from management
/me/removeAllDevicesFromManagementRetire all devices from management for this user - GETGet managed app diagnostic statuses
/me/getManagedAppDiagnosticStatuses()Gets diagnostics validation status for a given user. - GETGet managed devices with app failures
/me/getManagedDevicesWithAppFailures()Retrieves the list of devices with failed apps - POSTWipe managed app registrations by device tag
/me/wipeManagedAppRegistrationsByDeviceTagIssues a wipe operation on an app registration with specified device tag.
Cloud p cs
- GETList cloud p cs
/me/cloudPCsList the cloudPC devices that are attributed to the signed-in user. - POSTCreate cloud p c
/me/cloudPCs - GETGet cloud p c
/me/cloudPCs/:cloudPC-idThe user's Cloud PCs. Read-only. Nullable. - DELETEDelete cloud p c
/me/cloudPCs/:cloudPC-id - PATCHUpdate cloud p c
/me/cloudPCs/:cloudPC-id - POSTCreate reboot
/me/cloudPCs/:cloudPC-id/rebootReboot a specific cloudPC object. - POSTCreate rename
/me/cloudPCs/:cloudPC-id/renameRename a specific cloudPC object. Use this API to update the displayName of a Cloud PC entity. - POSTCreate resize
/me/cloudPCs/:cloudPC-id/resizeUpgrade or downgrade an existing Cloud PC to a configuration with a new virtual CPU (vCPU) and storage size. - POSTRestore cloud p c
/me/cloudPCs/:cloudPC-id/restoreRestore a specific cloudPC object to a previous state from a snapshot. Use this API to trigger a remote action that restores a Cloud PC device to a previous… - POSTCreate reprovision
/me/cloudPCs/:cloudPC-id/reprovisionReprovision a specific Cloud PC. - POSTCreate troubleshoot
/me/cloudPCs/:cloudPC-id/troubleshootTroubleshoot a specific cloudPC object. Use this API to check the health status of the Cloud PC and the session host. - POSTCreate end grace period
/me/cloudPCs/:cloudPC-id/endGracePeriodEnd the grace period for a specific cloudPC object. The grace period is triggered when the Cloud PC license is removed or the provisioning policy is… - GETRetrieve cloud pc launch detail (cloud p c)
/me/cloudPCs/:cloudPC-id/retrieveCloudPcLaunchDetail()Get the cloudPcLaunchDetail for a specific cloudPC that belongs to the current signed-in user.
Insights
- GETList insights
/me/insightsRepresents relationships between a user and items such as OneDrive for work or school documents, calculated using advanced analytics and machine learning… - DELETEDelete insights
/me/insights - PATCHUpdate insights
/me/insights
Member of
- GETGet member of
/me/memberOfThe groups and directory roles that the user is a member of. Read-only. Nullable. Supports $expand. - GETGet group
/me/memberOf/graph.group - GETGet directory role
/me/memberOf/graph.directoryRole - GETGet administrative unit
/me/memberOf/graph.administrativeUnit - GETGet member of
/me/memberOf/:directoryObject-idThe groups and directory roles that the user is a member of. Read-only. Nullable. Supports $expand. - GETGet group
/me/memberOf/:directoryObject-id/graph.group - GETGet directory role
/me/memberOf/:directoryObject-id/graph.directoryRole - GETGet administrative unit
/me/memberOf/:directoryObject-id/graph.administrativeUnit
Settings
- GETGet settings
/me/settingsRead the user and organization userSettings object. To learn how to update the properties of the userSettings object, see update user settings. - DELETEDelete settings
/me/settings - PATCHUpdate settings
/me/settingsUpdate the properties of the userSettings object. Users in the same organization can have different settings based on their preference or on the organization… - GETGet exchange
/me/settings/exchangeThe Exchange settings for mailbox discovery.
Sponsors
- GETList sponsors
/me/sponsorsThe users and groups responsible for this guest's privileges in the tenant and keeping the guest's information and access updated. (HTTP Methods: GET, POST,… - GETList references
/me/sponsors/$refThe users and groups responsible for this guest's privileges in the tenant and keeping the guest's information and access updated. (HTTP Methods: GET, POST,… - POSTAdd reference
/me/sponsors/$ref - DELETERemove reference
/me/sponsors/$ref?@id=string - DELETERemove reference
/me/sponsors/:directoryObject-id/$ref
Sponsor of
- GETGet sponsor of
/me/sponsorOfDirectory objects that this user sponsors, such as guest users, agent users, agent blueprints, agent blueprint principals, and agent identities. If the user… - GETGet sponsor of
/me/sponsorOf/:directoryObject-idDirectory objects that this user sponsors, such as guest users, agent users, agent blueprints, agent blueprint principals, and agent identities. If the user…
Activities
- GETList activities
/me/activitiesGet activities for a given user. Unlike the recent OData function, activities without histories will be returned. The permission… - POSTCreate activity
/me/activities - GETRecent activity
/me/activities/recent()Get recent activities for a given user. This OData function has some default behaviors included to make it operate like a 'most recently used' API. The… - GETGet activity
/me/activities/:userActivity-idThe user's activities across devices. Read-only. Nullable. - DELETEDelete activity
/me/activities/:userActivity-idDelete an existing user activity for your app. - PATCHUpdate activity
/me/activities/:userActivity-id
Extensions
- GETList extensions
/me/extensionsThe collection of open extensions defined for the user. Read-only. Supports $expand. Nullable. - POSTCreate extension
/me/extensions - GETGet extension
/me/extensions/:extension-idThe collection of open extensions defined for the user. Read-only. Supports $expand. Nullable. - DELETEDelete extension
/me/extensions/:extension-id - PATCHUpdate extension
/me/extensions/:extension-id
Owned devices
- GETList owned devices
/me/ownedDevicesGet the list of devices that are owned by the user. - GETGet device
/me/ownedDevices/graph.device - GETGet endpoint
/me/ownedDevices/graph.endpoint - GETGet app role assignment
/me/ownedDevices/graph.appRoleAssignment - GETGet owned device
/me/ownedDevices/:directoryObject-idDevices the user owns. Read-only. Nullable. Supports $expand and $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1). - GETGet device
/me/ownedDevices/:directoryObject-id/graph.device - GETGet endpoint
/me/ownedDevices/:directoryObject-id/graph.endpoint - GETGet app role assignment
/me/ownedDevices/:directoryObject-id/graph.appRoleAssignment
Owned objects
- GETList owned objects
/me/ownedObjectsGet the list of directory objects that are owned by the user. - GETGet group
/me/ownedObjects/graph.group - GETGet application
/me/ownedObjects/graph.application - GETGet service principal
/me/ownedObjects/graph.servicePrincipal - GETGet owned object
/me/ownedObjects/:directoryObject-idDirectory objects the user owns. Read-only. Nullable. Supports $expand, $select nested in $expand, and $filter (/$count eq 0, /$count ne 0, /$count eq 1,… - GETGet group
/me/ownedObjects/:directoryObject-id/graph.group - GETGet application
/me/ownedObjects/:directoryObject-id/graph.application - GETGet service principal
/me/ownedObjects/:directoryObject-id/graph.servicePrincipal
Direct reports
- GETList direct reports
/me/directReportsGet a user's direct reports. Returns the users and contacts for whom this user is assigned as manager. This API doesn't support getting the direct report… - GETGet user
/me/directReports/graph.user - GETGet org contact
/me/directReports/graph.orgContact - GETGet direct report
/me/directReports/:directoryObject-idThe users and contacts that report to the user. (The users and contacts that have their manager property set to this user.) Read-only. Nullable. Supports… - GETGet user
/me/directReports/:directoryObject-id/graph.user - GETGet org contact
/me/directReports/:directoryObject-id/graph.orgContact
Authentication
- GETGet authentication
/me/authenticationThe authentication methods that are supported for the user. - DELETEDelete authentication
/me/authentication - PATCHUpdate authentication
/me/authentication
Cloud clipboard
- GETGet cloud clipboard
/me/cloudClipboard - DELETEDelete cloud clipboard
/me/cloudClipboard - PATCHUpdate cloud clipboard
/me/cloudClipboard
Created objects
- GETList created objects
/me/createdObjectsGet a list of directory objects that were created by the user. This API returns only those directory objects that were created by a user who isn't in any… - GETGet service principal
/me/createdObjects/graph.servicePrincipal - GETGet created object
/me/createdObjects/:directoryObject-idDirectory objects that the user created. Read-only. Nullable. - GETGet service principal
/me/createdObjects/:directoryObject-id/graph.servicePrincipal
License details
- GETList license details
/me/licenseDetailsRetrieve a list of licenseDetails objects for enterprise users. This API returns details for licenses that are directly assigned and those transitively… - POSTCreate license detail
/me/licenseDetails - GETGet teams licensing details (license detail)
/me/licenseDetails/getTeamsLicensingDetails()Get the license status of a user in Microsoft Teams. - GETGet license detail
/me/licenseDetails/:licenseDetails-idA collection of this user's license details. Read-only. - DELETEDelete license detail
/me/licenseDetails/:licenseDetails-id - PATCHUpdate license detail
/me/licenseDetails/:licenseDetails-id
Permission grants
- GETList permission grants
/me/permissionGrantsList all resource-specific permission grants of a user. - POSTCreate permission grant
/me/permissionGrants - GETGet permission grant
/me/permissionGrants/:resourceSpecificPermissionGrant-idList all resource-specific permission grants of a user. - DELETEDelete permission grant
/me/permissionGrants/:resourceSpecificPermissionGrant-id - PATCHUpdate permission grant
/me/permissionGrants/:resourceSpecificPermissionGrant-id
Registered devices
- GETList registered devices
/me/registeredDevicesGet the list of user's registered devices. - GETGet device
/me/registeredDevices/graph.device - GETGet endpoint
/me/registeredDevices/graph.endpoint - GETGet app role assignment
/me/registeredDevices/graph.appRoleAssignment - GETGet registered device
/me/registeredDevices/:directoryObject-idDevices that are registered for the user. Read-only. Nullable. Supports $expand and returns up to 100 objects. - GETGet device
/me/registeredDevices/:directoryObject-id/graph.device - GETGet endpoint
/me/registeredDevices/:directoryObject-id/graph.endpoint - GETGet app role assignment
/me/registeredDevices/:directoryObject-id/graph.appRoleAssignment
App role assignments
- GETList app role assignments
/me/appRoleAssignmentsRepresents the app roles a user is granted for an application. Supports $expand. - POSTCreate app role assignment
/me/appRoleAssignments - GETGet app role assignment
/me/appRoleAssignments/:appRoleAssignment-idRepresents the app roles a user is granted for an application. Supports $expand. - DELETEDelete app role assignment
/me/appRoleAssignments/:appRoleAssignment-id - PATCHUpdate app role assignment
/me/appRoleAssignments/:appRoleAssignment-id
Scoped role member of
- GETGet scoped role member of
/me/scopedRoleMemberOf - POSTCreate scoped role member of
/me/scopedRoleMemberOf - GETGet scoped role member of
/me/scopedRoleMemberOf/:scopedRoleMembership-id - DELETEDelete scoped role member of
/me/scopedRoleMemberOf/:scopedRoleMembership-id - PATCHUpdate scoped role member of
/me/scopedRoleMemberOf/:scopedRoleMembership-id
Transitive member of
- GETGet transitive member of
/me/transitiveMemberOfThe groups, including nested groups, and directory roles that a user is a member of. Nullable. - GETGet group
/me/transitiveMemberOf/graph.group - GETGet directory role
/me/transitiveMemberOf/graph.directoryRole - GETGet administrative unit
/me/transitiveMemberOf/graph.administrativeUnit - GETGet transitive member of
/me/transitiveMemberOf/:directoryObject-idThe groups, including nested groups, and directory roles that a user is a member of. Nullable. - GETGet group
/me/transitiveMemberOf/:directoryObject-id/graph.group - GETGet directory role
/me/transitiveMemberOf/:directoryObject-id/graph.directoryRole - GETGet administrative unit
/me/transitiveMemberOf/:directoryObject-id/graph.administrativeUnit
Agreement acceptances
- GETList agreement acceptances
/me/agreementAcceptancesAllows the signed-in user to retrieve their agreementAcceptance objects. - GETGet agreement acceptance
/me/agreementAcceptances/:agreementAcceptance-idThe user's terms of use acceptance statuses. Read-only. Nullable.
Oauth2 permission grants
- GETList oauth2 permission grants
/me/oauth2PermissionGrants - GETGet oauth2 permission grant
/me/oauth2PermissionGrants/:oAuth2PermissionGrant-id
On premises sync behavior
- GETGet on premises sync behavior
/me/onPremisesSyncBehavior - DELETEDelete on premises sync behavior
/me/onPremisesSyncBehavior - PATCHUpdate on premises sync behavior
/me/onPremisesSyncBehavior
Data security and governance
- GETGet data security and governance
/me/dataSecurityAndGovernanceThe data security and governance settings for the user. Read-only. Nullable. - DELETEDelete data security and governance
/me/dataSecurityAndGovernance - PATCHUpdate data security and governance
/me/dataSecurityAndGovernance - POSTCreate process content
/me/dataSecurityAndGovernance/processContentProcess content against data protection policies in the context of the current, or specified, user.
Export device and app management data
- GETExport device and app management data
/me/exportDeviceAndAppManagementData() - GETExport device and app management data
/me/exportDeviceAndAppManagementData(skip=:skip,top=:top)
Insights: used
- GETGet used
/me/insights/usedDeprecated. Calculate and list the documents that a user has viewed or modified. For the signed-in user: This method includes documents that the user has… - POSTCreate used
/me/insights/usedDeprecated. - GETGet used
/me/insights/used/:usedInsight-idDeprecated. Calculated relationship that identifies the latest documents viewed or modified by a user, including OneDrive for work or school and SharePoint… - DELETEDelete used
/me/insights/used/:usedInsight-idDeprecated. - PATCHUpdate used
/me/insights/used/:usedInsight-idDeprecated. - GETGet resource
/me/insights/used/:usedInsight-id/resourceDeprecated. Used for navigating to the item that was used. For file attachments, the type is fileAttachment. For linked attachments, the type is driveItem.
Insights: shared
- GETGet shared
/me/insights/sharedDeprecated. Calculated insight that includes the list of documents shared with a user. This insight includes documents hosted on OneDrive/SharePoint in the… - POSTCreate shared
/me/insights/sharedDeprecated. - GETGet shared
/me/insights/shared/:sharedInsight-idDeprecated. Calculated relationship that identifies documents shared with or by the user. This includes URLs, file attachments, and reference attachments to… - DELETEDelete shared
/me/insights/shared/:sharedInsight-idDeprecated. - PATCHUpdate shared
/me/insights/shared/:sharedInsight-idDeprecated. - GETGet resource
/me/insights/shared/:sharedInsight-id/resourceDeprecated. Used for navigating to the item that was shared. For file attachments, the type is fileAttachment. For linked attachments, the type is driveItem. - GETGet last shared method
/me/insights/shared/:sharedInsight-id/lastSharedMethodDeprecated.
Settings: storage
- GETGet storage
/me/settings/storage - DELETEDelete storage
/me/settings/storage - PATCHUpdate storage
/me/settings/storage - GETGet quota
/me/settings/storage/quota - DELETEDelete quota
/me/settings/storage/quota - PATCHUpdate quota
/me/settings/storage/quota - GETList services
/me/settings/storage/quota/services - POSTCreate service
/me/settings/storage/quota/services - GETGet service
/me/settings/storage/quota/services/:serviceStorageQuotaBreakdown-id - DELETEDelete service
/me/settings/storage/quota/services/:serviceStorageQuotaBreakdown-id - PATCHUpdate service
/me/settings/storage/quota/services/:serviceStorageQuotaBreakdown-id
Settings: windows
- GETList windows
/me/settings/windowsGet a list of windowsSetting objects and their properties for the signed in user. - POSTCreate window
/me/settings/windows - GETGet window
/me/settings/windows/:windowsSetting-idRead the properties and relationships of a windowsSetting object by passing the ID of the setting in the URL. This method gets the setting for the signed-in… - DELETEDelete window
/me/settings/windows/:windowsSetting-id - PATCHUpdate window
/me/settings/windows/:windowsSetting-id - GETList instances
/me/settings/windows/:windowsSetting-id/instancesGet a list of windowsSettingInstance objects and their properties for the signed-in user. - POSTCreate instance
/me/settings/windows/:windowsSetting-id/instances - GETGet instance
/me/settings/windows/:windowsSetting-id/instances/:windowsSettingInstance-idRead the properties and relationships of a windowsSettingInstance object by passing the Windows setting ID and Windows setting instance ID in the URL. This… - DELETEDelete instance
/me/settings/windows/:windowsSetting-id/instances/:windowsSettingInstance-id - PATCHUpdate instance
/me/settings/windows/:windowsSetting-id/instances/:windowsSettingInstance-id
Insights: trending
- GETGet trending
/me/insights/trendingCalculated insight that includes a list of documents trending around the user. - POSTCreate trending
/me/insights/trending - GETGet trending
/me/insights/trending/:trending-idCalculated relationship that identifies documents trending around a user. Trending documents are calculated based on activity of the user's closest network of… - DELETEDelete trending
/me/insights/trending/:trending-id - PATCHUpdate trending
/me/insights/trending/:trending-id - GETGet resource
/me/insights/trending/:trending-id/resourceUsed for navigating to the trending document.
Cloud clipboard: items
- GETList items
/me/cloudClipboard/itemsRepresents a collection of Cloud Clipboard items. - POSTCreate item
/me/cloudClipboard/items - GETGet item
/me/cloudClipboard/items/:cloudClipboardItem-idRepresents a collection of Cloud Clipboard items. - DELETEDelete item
/me/cloudClipboard/items/:cloudClipboardItem-id - PATCHUpdate item
/me/cloudClipboard/items/:cloudClipboardItem-id
Settings: item insights
- GETList item insights
/me/settings/itemInsightsGet the user-customizable privacy settings for itemInsights and meeting hours insights. - DELETEDelete item insights
/me/settings/itemInsights - PATCHUpdate item insights
/me/settings/itemInsights
Authentication: methods
- GETList methods
/me/authentication/methodsRetrieve a list of authentication methods registered to a user. The authentication methods are defined by the types derived from the authenticationMethod… - POSTCreate method
/me/authentication/methods - GETGet method
/me/authentication/methods/:authenticationMethod-idRetrieve the properties and relationships of an authenticationMethod object. - PATCHUpdate method
/me/authentication/methods/:authenticationMethod-id - POSTReset password (method)
/me/authentication/methods/:authenticationMethod-id/resetPasswordReset a user's password, represented by a password authentication method object. This can only be done by an administrator with appropriate permissions and…
Authentication: operations
- GETList operations
/me/authentication/operationsRepresents the status of a long-running operation, such as a password reset operation. - POSTCreate operation
/me/authentication/operations - GETGet operation
/me/authentication/operations/:longRunningOperation-idRepresents the status of a long-running operation, such as a password reset operation. - DELETEDelete operation
/me/authentication/operations/:longRunningOperation-id - PATCHUpdate operation
/me/authentication/operations/:longRunningOperation-id
Settings: shift preferences
- GETList shift preferences
/me/settings/shiftPreferences - DELETEDelete shift preferences
/me/settings/shiftPreferences - PATCHUpdate shift preferences
/me/settings/shiftPreferences
Authentication: email methods
- GETList email methods
/me/authentication/emailMethodsRetrieve a list of a user's email authentication method objects and their properties. This call only returns a single object referenced by ID… - POSTCreate email method
/me/authentication/emailMethods - GETGet email method
/me/authentication/emailMethods/:emailAuthenticationMethod-idRetrieve a user's single email authentication method object. - DELETEDelete email method
/me/authentication/emailMethods/:emailAuthenticationMethod-id - PATCHUpdate email method
/me/authentication/emailMethods/:emailAuthenticationMethod-id
Authentication: fido2 methods
- GETList fido2 methods
/me/authentication/fido2MethodsRetrieve a list of a user's passkey (FIDO2) authentication method objects and their properties. - GETCreation options (fido2 method)
/me/authentication/fido2Methods/creationOptions()Retrieve creation options required to generate and register a Microsoft Entra ID-compatible passkey. This function returns WebAuthn credential creation… - GETGet fido2 method
/me/authentication/fido2Methods/:fido2AuthenticationMethod-idRetrieve a user's single passkey (FIDO2) authentication method object. - DELETEDelete fido2 method
/me/authentication/fido2Methods/:fido2AuthenticationMethod-id
Authentication: phone methods
- GETList phone methods
/me/authentication/phoneMethodsRetrieve a list of phone authentication method objects for a user. This will return up to three objects, as a user can have up to three phones usable for… - POSTCreate phone method
/me/authentication/phoneMethods - GETGet phone method
/me/authentication/phoneMethods/:phoneAuthenticationMethod-idRetrieve a single phoneAuthenticationMethod object for a user. This method is available only for standard Microsoft Entra ID and B2B users, but not B2C users. - DELETEDelete phone method
/me/authentication/phoneMethods/:phoneAuthenticationMethod-idDelete a user's phone authentication method. This removes the phone number from the user and they'll no longer be able to use the number for authentication,… - PATCHUpdate phone method
/me/authentication/phoneMethods/:phoneAuthenticationMethod-id - POSTCreate enable sms sign in
/me/authentication/phoneMethods/:phoneAuthenticationMethod-id/enableSmsSignInEnable SMS sign-in for an existing mobile phone number registered to a user. To be successfully enabled: - POSTCreate disable sms sign in
/me/authentication/phoneMethods/:phoneAuthenticationMethod-id/disableSmsSignInDisable SMS sign-in for an existing mobile phone number registered to a user. The number will no longer be available for SMS sign-in, which can prevent your…
Authentication: password methods
- GETList password methods
/me/authentication/passwordMethodsRetrieve a list of the passwords registered to a user, represented by a passwordAuthenticationMethod object. This API returns exactly one object referenced by… - POSTCreate password method
/me/authentication/passwordMethods - GETGet password method
/me/authentication/passwordMethods/:passwordAuthenticationMethod-idRetrieve a password that's registered to a user, represented by a passwordAuthenticationMethod object. For security, the password itself will never be…
Settings: work hours and locations
- GETList work hours and locations
/me/settings/workHoursAndLocationsGet the properties and relationships of a user's workHoursAndLocationsSetting. - PATCHUpdate work hours and locations
/me/settings/workHoursAndLocationsUpdate the properties of a user's workHoursAndLocationsSetting. - GETList occurrences
/me/settings/workHoursAndLocations/occurrencesCollection of work plan occurrences. - POSTCreate occurrence
/me/settings/workHoursAndLocations/occurrencesCreate a new workPlanOccurrence object in a user's work plan. Only time-off occurrences can be created directly. The workLocationType must be set to timeOff.… - GETList recurrences
/me/settings/workHoursAndLocations/recurrencesGet the recurrences from a user's work plan via the recurrences navigation property. - POSTCreate recurrence
/me/settings/workHoursAndLocations/recurrencesCreate a new workPlanRecurrence object in a user's work plan. - GETGet work hours and location
/me/settings/workHoursAndLocations/occurrencesView(startDateTime=':startDateTime',endDateTime=':endDateTime')Get work plan occurrences from a user's work plan within a specified date range. This function requires the startDateTime and endDateTime parameters. - POSTSet current location (occurrence)
/me/settings/workHoursAndLocations/occurrences/setCurrentLocationUpdate a user's work location for the current day or current active segment. This action quickly updates the user's work location without modifying individual… - GETGet occurrence
/me/settings/workHoursAndLocations/occurrences/:workPlanOccurrence-idCollection of work plan occurrences. - PUTReplace occurrence
/me/settings/workHoursAndLocations/occurrences/:workPlanOccurrence-id - DELETEDelete occurrence
/me/settings/workHoursAndLocations/occurrences/:workPlanOccurrence-id - GETGet recurrence
/me/settings/workHoursAndLocations/recurrences/:workPlanRecurrence-idCollection of recurring work plans defined by the user. - PUTReplace recurrence
/me/settings/workHoursAndLocations/recurrences/:workPlanRecurrence-id - DELETEDelete recurrence
/me/settings/workHoursAndLocations/recurrences/:workPlanRecurrence-id
Authentication: software oath methods
- GETList software oath methods
/me/authentication/softwareOathMethodsRetrieve a list of a user's software OATH token authentication method objects and their properties. - GETGet software oath method
/me/authentication/softwareOathMethods/:softwareOathAuthenticationMethod-idRetrieve a user's single Software OATH token authentication method object and its properties. - DELETEDelete software oath method
/me/authentication/softwareOathMethods/:softwareOathAuthenticationMethod-id
Data security and governance: activities
- GETList activities
/me/dataSecurityAndGovernance/activitiesContainer for activity logs (content processing and audit) related to this user. ContainsTarget: true. - DELETEDelete activities
/me/dataSecurityAndGovernance/activities - PATCHUpdate activities
/me/dataSecurityAndGovernance/activities - GETList content activities
/me/dataSecurityAndGovernance/activities/contentActivitiesCollection of activity logs related to content processing. - POSTCreate content activity
/me/dataSecurityAndGovernance/activities/contentActivitiesCreate a content activity for the signed-in user. - GETGet content activity
/me/dataSecurityAndGovernance/activities/contentActivities/:contentActivity-idCollection of activity logs related to content processing. - DELETEDelete content activity
/me/dataSecurityAndGovernance/activities/contentActivities/:contentActivity-id - PATCHUpdate content activity
/me/dataSecurityAndGovernance/activities/contentActivities/:contentActivity-id
Authentication: platform credential methods
- GETList platform credential methods
/me/authentication/platformCredentialMethodsGet a list of the platformCredentialAuthenticationMethod objects and their properties. - GETGet platform credential method
/me/authentication/platformCredentialMethods/:platformCredentialAuthenticationMethod-idRead the properties and relationships of a platformCredentialAuthenticationMethod object. - DELETEDelete platform credential method
/me/authentication/platformCredentialMethods/:platformCredentialAuthenticationMethod-id - GETGet device
/me/authentication/platformCredentialMethods/:platformCredentialAuthenticationMethod-id/deviceThe registered device on which this Platform Credential resides. Supports $expand. When you get a user's Platform Credential registration information, this…
Authentication: temporary access pass methods
- GETList temporary access pass methods
/me/authentication/temporaryAccessPassMethodsRepresents a Temporary Access Pass registered to a user for authentication through time-limited passcodes. - POSTCreate temporary access pass method
/me/authentication/temporaryAccessPassMethods - GETGet temporary access pass method
/me/authentication/temporaryAccessPassMethods/:temporaryAccessPassAuthenticationMethod-idRepresents a Temporary Access Pass registered to a user for authentication through time-limited passcodes. - DELETEDelete temporary access pass method
/me/authentication/temporaryAccessPassMethods/:temporaryAccessPassAuthenticationMethod-id
Data security and governance: protection scopes
- GETList protection scopes
/me/dataSecurityAndGovernance/protectionScopes - DELETEDelete protection scopes
/me/dataSecurityAndGovernance/protectionScopes - PATCHUpdate protection scopes
/me/dataSecurityAndGovernance/protectionScopes - POSTCreate compute
/me/dataSecurityAndGovernance/protectionScopes/compute
Data security and governance: sensitivity labels
- GETList sensitivity labels
/me/dataSecurityAndGovernance/sensitivityLabels - POSTCreate sensitivity label
/me/dataSecurityAndGovernance/sensitivityLabels - POSTCreate compute rights and inheritance
/me/dataSecurityAndGovernance/sensitivityLabels/computeRightsAndInheritanceComputes the rights and inheritance for sensitivity labels based on the input content and labels. - GETGet sensitivity label
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id - DELETEDelete sensitivity label
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id - PATCHUpdate sensitivity label
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id - GETGet sensitivity label
/me/dataSecurityAndGovernance/sensitivityLabels/computeInheritance(labelIds=:labelIds,locale=':locale',contentFormats=:contentFormats)Calculate the sensitivity label that should be inherited by an output artifact, given a set of sensitivity labels from input or referenced artifacts. - GETList rights
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/rights - GETList sublabels
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/sublabels - POSTCreate sublabel
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/sublabels - GETGet sublabel
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/sublabels/:sensitivityLabel-id1 - DELETEDelete sublabel
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/sublabels/:sensitivityLabel-id1 - PATCHUpdate sublabel
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/sublabels/:sensitivityLabel-id1 - POSTCreate compute rights and inheritance
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/sublabels/computeRightsAndInheritanceComputes the rights and inheritance for sensitivity labels based on the input content and labels. - GETGet sublabel
/me/dataSecurityAndGovernance/sensitivityLabels/:sensitivityLabel-id/sublabels/computeInheritance(labelIds=:labelIds,locale=':locale',contentFormats=:contentFormats)Calculate the sensitivity label that should be inherited by an output artifact, given a set of sensitivity labels from input or referenced artifacts.
Showing 300 of 346 endpoints. Fork the collection to see all of them.
API details
- Base URL
https://graph.microsoft.com/v1.0- Authentication
- OAuth 2.0 (authorization code, client credentials flows)
- Operations
- 346 operations on 214 pathsGET 181POST 64DELETE 54PATCH 42PUT 5
13 marked deprecated - Main resources
- Actions and more 17Data security and governance: sensitivity labels 16Settings: work hours and locations 14Cloud p cs 13Users 12Settings: storage 11Settings: windows 10Data security and governance: activities 8Member of 8Owned devices 8
- Description format
- OpenAPI 3.0.4, API version
v1.0 - Links
- Documentation · OpenAPI document
How to test the Microsoft Graph: Users and profiles in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Users and profiles collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get me” (GET /me), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Microsoft Graph: Users and profiles?
Read and update the signed-in user and other users: profile, photo, manager and direct reports, group memberships, licences, authentication methods, settings… It is listed under Identity & security and has 346 endpoints.
Who publishes the Microsoft Graph: Users and profiles?
It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Microsoft Graph: Users and profiles?
Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.
How do I authenticate with the Microsoft Graph: Users and profiles?
With OAuth 2.0 (authorization code, client credentials flows).
How many endpoints does the Microsoft Graph: Users and profiles have?
346 operations on 214 paths (181 GET, 64 POST, 54 DELETE, 42 PATCH, 5 PUT). The largest groups are Actions and more, Data security and governance: sensitivity labels, Settings: work hours and locations, Cloud p cs.
Is forking the Microsoft Graph: Users and profiles free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.