Microsoft Entra ID (formerly Azure AD)

Azure Active Directory Users API

User accounts in the directory

GitHub OpenAPI

Operations 272

Showing the first 250 of 272. The full set is in the contract, and via get_provider_operations.

GET /users List users #
POST /users Create User #
GET /users/{user-id} Get a user #
PATCH /users/{user-id} Update user #
DELETE /users/{user-id} Delete a user #
GET /users/{user-id}/createdObjects Get createdObjects from users #
GET /users/{user-id}/createdObjects/{directoryObject-id} Get createdObjects from users #
GET /users/{user-id}/createdObjects/{directoryObject-id}/microsoft.graph.servicePrincipal Get the item of type microsoft.graph.directoryObject as microsoft.graph.servicePrincipal #
GET /users/{user-id}/createdObjects/$count Get the number of the resource #
GET /users/{user-id}/createdObjects/microsoft.graph.servicePrincipal Get the items of type microsoft.graph.servicePrincipal in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/createdObjects/microsoft.graph.servicePrincipal/$count Get the number of the resource #
GET /users/{user-id}/directReports List directReports (for agentUser) #
GET /users/{user-id}/directReports/{directoryObject-id} Get directReports from users #
GET /users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.orgContact Get the item of type microsoft.graph.directoryObject as microsoft.graph.orgContact #
GET /users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.user Get the item of type microsoft.graph.directoryObject as microsoft.graph.user #
GET /users/{user-id}/directReports/$count Get the number of the resource #
GET /users/{user-id}/directReports/microsoft.graph.orgContact Get the items of type microsoft.graph.orgContact in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/directReports/microsoft.graph.orgContact/$count Get the number of the resource #
GET /users/{user-id}/directReports/microsoft.graph.user Get the items of type microsoft.graph.user in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/directReports/microsoft.graph.user/$count Get the number of the resource #
GET /users/{user-id}/extensions Get extensions from users #
POST /users/{user-id}/extensions Create new navigation property to extensions for users #
GET /users/{user-id}/extensions/{extension-id} Get extensions from users #
PATCH /users/{user-id}/extensions/{extension-id} Update the navigation property extensions in users #
DELETE /users/{user-id}/extensions/{extension-id} Delete navigation property extensions for users #
GET /users/{user-id}/extensions/$count Get the number of the resource #
GET /users/{user-id}/insights Get insights from users #
PATCH /users/{user-id}/insights Update the navigation property insights in users #
DELETE /users/{user-id}/insights Delete navigation property insights for users #
GET /users/{user-id}/insights/shared Get shared from users #
POST /users/{user-id}/insights/shared Create new navigation property to shared for users #
GET /users/{user-id}/insights/shared/{sharedInsight-id} Get shared from users #
PATCH /users/{user-id}/insights/shared/{sharedInsight-id} Update the navigation property shared in users #
DELETE /users/{user-id}/insights/shared/{sharedInsight-id} Delete navigation property shared for users #
GET /users/{user-id}/insights/shared/{sharedInsight-id}/lastSharedMethod Get lastSharedMethod from users #
GET /users/{user-id}/insights/shared/{sharedInsight-id}/resource Get resource from users #
GET /users/{user-id}/insights/shared/$count Get the number of the resource #
GET /users/{user-id}/insights/trending Get trending from users #
POST /users/{user-id}/insights/trending Create new navigation property to trending for users #
GET /users/{user-id}/insights/trending/{trending-id} Get trending from users #
PATCH /users/{user-id}/insights/trending/{trending-id} Update the navigation property trending in users #
DELETE /users/{user-id}/insights/trending/{trending-id} Delete navigation property trending for users #
GET /users/{user-id}/insights/trending/{trending-id}/resource Get resource from users #
GET /users/{user-id}/insights/trending/$count Get the number of the resource #
GET /users/{user-id}/insights/used Get used from users #
POST /users/{user-id}/insights/used Create new navigation property to used for users #
GET /users/{user-id}/insights/used/{usedInsight-id} Get used from users #
PATCH /users/{user-id}/insights/used/{usedInsight-id} Update the navigation property used in users #
DELETE /users/{user-id}/insights/used/{usedInsight-id} Delete navigation property used for users #
GET /users/{user-id}/insights/used/{usedInsight-id}/resource Get resource from users #
GET /users/{user-id}/insights/used/$count Get the number of the resource #
GET /users/{user-id}/licenseDetails Get licenseDetails from users #
POST /users/{user-id}/licenseDetails Create new navigation property to licenseDetails for users #
GET /users/{user-id}/licenseDetails/{licenseDetails-id} Get licenseDetails from users #
PATCH /users/{user-id}/licenseDetails/{licenseDetails-id} Update the navigation property licenseDetails in users #
DELETE /users/{user-id}/licenseDetails/{licenseDetails-id} Delete navigation property licenseDetails for users #
GET /users/{user-id}/licenseDetails/$count Get the number of the resource #
GET /users/{user-id}/licenseDetails/microsoft.graph.getTeamsLicensingDetails() Invoke function getTeamsLicensingDetails #
GET /users/{user-id}/mailboxSettings Get mailboxSettings property value #
PATCH /users/{user-id}/mailboxSettings Update property mailboxSettings value. #
GET /users/{user-id}/manager List manager (for agentUser) #
GET /users/{user-id}/manager/$ref List manager (for agentUser) #
PUT /users/{user-id}/manager/$ref Assign manager #
DELETE /users/{user-id}/manager/$ref Remove manager (for agentUser) #
GET /users/{user-id}/memberOf List agentUser direct memberships #
GET /users/{user-id}/memberOf/{directoryObject-id} Get memberOf from users #
GET /users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit Get the item of type microsoft.graph.directoryObject as microsoft.graph.administrativeUnit #
GET /users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.directoryRole Get the item of type microsoft.graph.directoryObject as microsoft.graph.directoryRole #
GET /users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.group List a user's direct memberships #
GET /users/{user-id}/memberOf/$count Get the number of the resource #
GET /users/{user-id}/memberOf/microsoft.graph.administrativeUnit Get the items of type microsoft.graph.administrativeUnit in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/memberOf/microsoft.graph.administrativeUnit/$count Get the number of the resource #
GET /users/{user-id}/memberOf/microsoft.graph.directoryRole Get the items of type microsoft.graph.directoryRole in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/memberOf/microsoft.graph.directoryRole/$count Get the number of the resource #
GET /users/{user-id}/memberOf/microsoft.graph.group List a user's direct memberships #
GET /users/{user-id}/memberOf/microsoft.graph.group/$count Get the number of the resource #
GET /users/{user-id}/oauth2PermissionGrants List a user's oauth2PermissionGrants #
GET /users/{user-id}/oauth2PermissionGrants/{oAuth2PermissionGrant-id} Get oauth2PermissionGrants from users #
GET /users/{user-id}/oauth2PermissionGrants/$count Get the number of the resource #
GET /users/{user-id}/onPremisesSyncBehavior Get onPremisesSyncBehavior from users #
PATCH /users/{user-id}/onPremisesSyncBehavior Update the navigation property onPremisesSyncBehavior in users #
DELETE /users/{user-id}/onPremisesSyncBehavior Delete navigation property onPremisesSyncBehavior for users #
GET /users/{user-id}/outlook Get outlook from users #
GET /users/{user-id}/outlook/masterCategories Get masterCategories from users #
POST /users/{user-id}/outlook/masterCategories Create new navigation property to masterCategories for users #
GET /users/{user-id}/outlook/masterCategories/{outlookCategory-id} Get masterCategories from users #
PATCH /users/{user-id}/outlook/masterCategories/{outlookCategory-id} Update the navigation property masterCategories in users #
DELETE /users/{user-id}/outlook/masterCategories/{outlookCategory-id} Delete navigation property masterCategories for users #
GET /users/{user-id}/outlook/masterCategories/$count Get the number of the resource #
GET /users/{user-id}/outlook/microsoft.graph.supportedLanguages() Invoke function supportedLanguages #
GET /users/{user-id}/outlook/microsoft.graph.supportedTimeZones() Invoke function supportedTimeZones #
GET /users/{user-id}/outlook/microsoft.graph.supportedTimeZones(TimeZoneStandard='{TimeZoneStandard}') Invoke function supportedTimeZones #
GET /users/{user-id}/ownedDevices Get ownedDevices from users #
GET /users/{user-id}/ownedDevices/{directoryObject-id} Get ownedDevices from users #
GET /users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.appRoleAssignment Get the item of type microsoft.graph.directoryObject as microsoft.graph.appRoleAssignment #
GET /users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.device Get the item of type microsoft.graph.directoryObject as microsoft.graph.device #
GET /users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.endpoint Get the item of type microsoft.graph.directoryObject as microsoft.graph.endpoint #
GET /users/{user-id}/ownedDevices/$count Get the number of the resource #
GET /users/{user-id}/ownedDevices/microsoft.graph.appRoleAssignment Get the items of type microsoft.graph.appRoleAssignment in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/ownedDevices/microsoft.graph.appRoleAssignment/$count Get the number of the resource #
GET /users/{user-id}/ownedDevices/microsoft.graph.device Get the items of type microsoft.graph.device in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/ownedDevices/microsoft.graph.device/$count Get the number of the resource #
GET /users/{user-id}/ownedDevices/microsoft.graph.endpoint Get the items of type microsoft.graph.endpoint in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/ownedDevices/microsoft.graph.endpoint/$count Get the number of the resource #
GET /users/{user-id}/ownedObjects List ownedObjects (for agentUser) #
GET /users/{user-id}/ownedObjects/{directoryObject-id} Get ownedObjects from users #
GET /users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.application Get the item of type microsoft.graph.directoryObject as microsoft.graph.application #
GET /users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.group Get the item of type microsoft.graph.directoryObject as microsoft.graph.group #
GET /users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.servicePrincipal Get the item of type microsoft.graph.directoryObject as microsoft.graph.servicePrincipal #
GET /users/{user-id}/ownedObjects/$count Get the number of the resource #
GET /users/{user-id}/ownedObjects/microsoft.graph.application Get the items of type microsoft.graph.application in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/ownedObjects/microsoft.graph.application/$count Get the number of the resource #
GET /users/{user-id}/ownedObjects/microsoft.graph.group Get the items of type microsoft.graph.group in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/ownedObjects/microsoft.graph.group/$count Get the number of the resource #
GET /users/{user-id}/ownedObjects/microsoft.graph.servicePrincipal Get the items of type microsoft.graph.servicePrincipal in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/ownedObjects/microsoft.graph.servicePrincipal/$count Get the number of the resource #
GET /users/{user-id}/photo Get photo from users #
PATCH /users/{user-id}/photo Update the navigation property photo in users #
DELETE /users/{user-id}/photo Delete navigation property photo for users #
GET /users/{user-id}/photo/$value Get media content for the navigation property photo from users #
PUT /users/{user-id}/photo/$value Update media content for the navigation property photo in users #
DELETE /users/{user-id}/photo/$value Delete media content for the navigation property photo in users #
GET /users/{user-id}/photos Get photos from users #
GET /users/{user-id}/photos/{profilePhoto-id} Get photos from users #
GET /users/{user-id}/photos/{profilePhoto-id}/$value Get media content for the navigation property photos from users #
PUT /users/{user-id}/photos/{profilePhoto-id}/$value Update media content for the navigation property photos in users #
DELETE /users/{user-id}/photos/{profilePhoto-id}/$value Delete media content for the navigation property photos in users #
GET /users/{user-id}/registeredDevices Get registeredDevices from users #
GET /users/{user-id}/registeredDevices/{directoryObject-id} Get registeredDevices from users #
GET /users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.appRoleAssignment Get the item of type microsoft.graph.directoryObject as microsoft.graph.appRoleAssignment #
GET /users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.device Get the item of type microsoft.graph.directoryObject as microsoft.graph.device #
GET /users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.endpoint Get the item of type microsoft.graph.directoryObject as microsoft.graph.endpoint #
GET /users/{user-id}/registeredDevices/$count Get the number of the resource #
GET /users/{user-id}/registeredDevices/microsoft.graph.appRoleAssignment Get the items of type microsoft.graph.appRoleAssignment in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/registeredDevices/microsoft.graph.appRoleAssignment/$count Get the number of the resource #
GET /users/{user-id}/registeredDevices/microsoft.graph.device Get the items of type microsoft.graph.device in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/registeredDevices/microsoft.graph.device/$count Get the number of the resource #
GET /users/{user-id}/registeredDevices/microsoft.graph.endpoint Get the items of type microsoft.graph.endpoint in the microsoft.graph.directoryObject collection #
GET /users/{user-id}/registeredDevices/microsoft.graph.endpoint/$count Get the number of the resource #
GET /users/{user-id}/settings Get settings from users #
PATCH /users/{user-id}/settings Update the navigation property settings in users #
DELETE /users/{user-id}/settings Delete navigation property settings for users #
GET /users/{user-id}/settings/exchange List Exchange settings #
GET /users/{user-id}/settings/itemInsights Get itemInsights from users #
PATCH /users/{user-id}/settings/itemInsights Update userInsightsSettings #
DELETE /users/{user-id}/settings/itemInsights Delete navigation property itemInsights for users #
GET /users/{user-id}/settings/shiftPreferences Get shiftPreferences #
PATCH /users/{user-id}/settings/shiftPreferences Update shiftPreferences #
DELETE /users/{user-id}/settings/shiftPreferences Delete navigation property shiftPreferences for users #
GET /users/{user-id}/settings/storage Get storage from users #
PATCH /users/{user-id}/settings/storage Update the navigation property storage in users #
DELETE /users/{user-id}/settings/storage Delete navigation property storage for users #
GET /users/{user-id}/settings/storage/quota Get quota from users #
PATCH /users/{user-id}/settings/storage/quota Update the navigation property quota in users #
DELETE /users/{user-id}/settings/storage/quota Delete navigation property quota for users #
GET /users/{user-id}/settings/storage/quota/services Get services from users #
POST /users/{user-id}/settings/storage/quota/services Create new navigation property to services for users #
GET /users/{user-id}/settings/storage/quota/services/{serviceStorageQuotaBreakdown-id} Get services from users #
PATCH /users/{user-id}/settings/storage/quota/services/{serviceStorageQuotaBreakdown-id} Update the navigation property services in users #
DELETE /users/{user-id}/settings/storage/quota/services/{serviceStorageQuotaBreakdown-id} Delete navigation property services for users #
GET /users/{user-id}/settings/storage/quota/services/$count Get the number of the resource #
GET /users/{user-id}/settings/windows Get windows from users #
POST /users/{user-id}/settings/windows Create new navigation property to windows for users #
GET /users/{user-id}/settings/windows/{windowsSetting-id} Get windows from users #
PATCH /users/{user-id}/settings/windows/{windowsSetting-id} Update the navigation property windows in users #
DELETE /users/{user-id}/settings/windows/{windowsSetting-id} Delete navigation property windows for users #
GET /users/{user-id}/settings/windows/{windowsSetting-id}/instances Get instances from users #
POST /users/{user-id}/settings/windows/{windowsSetting-id}/instances Create new navigation property to instances for users #
GET /users/{user-id}/settings/windows/{windowsSetting-id}/instances/{windowsSettingInstance-id} Get instances from users #
PATCH /users/{user-id}/settings/windows/{windowsSetting-id}/instances/{windowsSettingInstance-id} Update the navigation property instances in users #
DELETE /users/{user-id}/settings/windows/{windowsSetting-id}/instances/{windowsSettingInstance-id} Delete navigation property instances for users #
GET /users/{user-id}/settings/windows/{windowsSetting-id}/instances/$count Get the number of the resource #
GET /users/{user-id}/settings/windows/$count Get the number of the resource #
GET /users/{user-id}/settings/workHoursAndLocations Get workHoursAndLocations from users #
PATCH /users/{user-id}/settings/workHoursAndLocations Update the navigation property workHoursAndLocations in users #
GET /users/{user-id}/settings/workHoursAndLocations/microsoft.graph.occurrencesView(startDateTime='{startDateTime}',endDateTime='{endDateTime}') Invoke function occurrencesView #
GET /users/{user-id}/settings/workHoursAndLocations/occurrences Get occurrences from users #
POST /users/{user-id}/settings/workHoursAndLocations/occurrences Create new navigation property to occurrences for users #
GET /users/{user-id}/settings/workHoursAndLocations/occurrences/{workPlanOccurrence-id} Get occurrences from users #
PUT /users/{user-id}/settings/workHoursAndLocations/occurrences/{workPlanOccurrence-id} Update the navigation property occurrences in users #
DELETE /users/{user-id}/settings/workHoursAndLocations/occurrences/{workPlanOccurrence-id} Delete navigation property occurrences for users #
GET /users/{user-id}/settings/workHoursAndLocations/occurrences/$count Get the number of the resource #
POST /users/{user-id}/settings/workHoursAndLocations/occurrences/microsoft.graph.setCurrentLocation Invoke action setCurrentLocation #
GET /users/{user-id}/settings/workHoursAndLocations/recurrences Get recurrences from users #
POST /users/{user-id}/settings/workHoursAndLocations/recurrences Create new navigation property to recurrences for users #
GET /users/{user-id}/settings/workHoursAndLocations/recurrences/{workPlanRecurrence-id} Get recurrences from users #
PUT /users/{user-id}/settings/workHoursAndLocations/recurrences/{workPlanRecurrence-id} Update the navigation property recurrences in users #
DELETE /users/{user-id}/settings/workHoursAndLocations/recurrences/{workPlanRecurrence-id} Delete navigation property recurrences for users #
GET /users/{user-id}/settings/workHoursAndLocations/recurrences/$count Get the number of the resource #
GET /users/{user-id}/sponsorOf List sponsorOf #
GET /users/{user-id}/sponsorOf/{directoryObject-id} Get sponsorOf from users #
GET /users/{user-id}/sponsorOf/$count Get the number of the resource #
GET /users/{user-id}/sponsors List sponsors (for agentUser) #
DELETE /users/{user-id}/sponsors/{directoryObject-id}/$ref Remove sponsor (for agentUser) #
GET /users/{user-id}/sponsors/$count Get the number of the resource #
GET /users/{user-id}/sponsors/$ref List sponsors (for agentUser) #
POST /users/{user-id}/sponsors/$ref Add sponsors (for agentUser) #
DELETE /users/{user-id}/sponsors/$ref Remove sponsor (for agentUser) #
GET /users/{user-id}/todo Get todo from users #
PATCH /users/{user-id}/todo Update the navigation property todo in users #
DELETE /users/{user-id}/todo Delete navigation property todo for users #
GET /users/{user-id}/todo/lists Get lists from users #
POST /users/{user-id}/todo/lists Create new navigation property to lists for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id} Get lists from users #
PATCH /users/{user-id}/todo/lists/{todoTaskList-id} Update the navigation property lists in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id} Delete navigation property lists for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions Get extensions from users #
POST /users/{user-id}/todo/lists/{todoTaskList-id}/extensions Create new navigation property to extensions for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id} Get extensions from users #
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id} Update the navigation property extensions in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/{extension-id} Delete navigation property extensions for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/extensions/$count Get the number of the resource #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks Get tasks from users #
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks Create new navigation property to tasks for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id} Get tasks from users #
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id} Update the navigation property tasks in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id} Delete navigation property tasks for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments Get attachments from users #
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments Create new navigation property to attachments for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id} Get attachments from users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id} Delete navigation property attachments for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value Get media content for the navigation property attachments from users #
PUT /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value Update media content for the navigation property attachments in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/{attachmentBase-id}/$value Delete media content for the navigation property attachments in users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/$count Get the number of the resource #
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachments/microsoft.graph.createUploadSession Invoke action createUploadSession #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions Get attachmentSessions from users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id} Get attachmentSessions from users #
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id} Update the navigation property attachmentSessions in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id} Delete navigation property attachmentSessions for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content Get content for the navigation property attachmentSessions from users #
PUT /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content Update content for the navigation property attachmentSessions in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/{attachmentSession-id}/content Delete content for the navigation property attachmentSessions in users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/attachmentSessions/$count Get the number of the resource #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems Get checklistItems from users #
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems Create new navigation property to checklistItems for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id} Get checklistItems from users #
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id} Update the navigation property checklistItems in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/{checklistItem-id} Delete navigation property checklistItems for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/checklistItems/$count Get the number of the resource #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions Get extensions from users #
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions Create new navigation property to extensions for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id} Get extensions from users #
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id} Update the navigation property extensions in users #
DELETE /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/{extension-id} Delete navigation property extensions for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/extensions/$count Get the number of the resource #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources Get linkedResources from users #
POST /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources Create new navigation property to linkedResources for users #
GET /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id} Get linkedResources from users #
PATCH /users/{user-id}/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}/linkedResources/{linkedResource-id} Update the navigation property linkedResources in users #

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/_original/azure-ad-graph-users-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/overlays/azure-ad-graph-users-overlay.yaml
🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/azure-ad-users-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-ad-graph-users-openapi.yml Raw ↑ 
openapi: 3.0.4
info:
  title: Users
  version: v1.0
servers:
  - url: https://graph.microsoft.com/v1.0/
    description: Core
paths:
  /users:
    get:
      tags:
        - users.user
      summary: List users
      description: Retrieve a list of user objects.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/user-list?view=graph-rest-1.0
      operationId: user_ListUser
      parameters:
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.userCollectionResponse'
        default:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
        - users.user
      summary: Create User
      description: "Create a new user.\r\nThe request body contains the user to create. At a minimum, you must specify the required properties for the user. You can optionally specify any other writable properties."
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/user-post-users?view=graph-rest-1.0
      operationId: user_CreateUser
      requestBody:
        description: New entity
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.user'
        required: true
      responses:
        2XX:
          description: Created entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.user'
        default:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  '/users/{user-id}':
    get:
      tags:
        - users.user
      summary: Get a user
      description: 'Retrieve the properties and relationships of user object. This operation returns by default only a subset of the more commonly used properties for each user. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation for the user and specify the properties in a $select OData query option. Because the user resource supports extensions, you can also use the GET operation to get custom properties and extension data in a user instance. Customers through Microsoft Entra ID for customers can also use this API operation to retrieve their details.'
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/user-get?view=graph-rest-1.0
      operationId: user_GetUser
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.user'
        default:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - users.user
      summary: Update user
      description: 'Update 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 the request body.'
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/user-update?view=graph-rest-1.0
      operationId: user_UpdateUser
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.user'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.user'
        default:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - users.user
      summary: Delete a user
      description: 'Delete a user object.   When deleted, user resources, including their mailbox and license assignments, are moved to a temporary container and if the user is restored within 30 days, these objects are restored to them. The user is also restored to any groups they were a member of. After 30 days and if not restored, the user object is permanently deleted and their assigned resources freed. To manage the deleted user object, see deletedItems.'
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/user-delete?view=graph-rest-1.0
      operationId: user_DeleteUser
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: If-Match
          in: header
          description: ETag
          style: simple
          schema:
            type: string
      responses:
        2XX:
          description: Success
        default:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  '/users/{user-id}/createdObjects':
    get:
      tags:
        - users.directoryObject
      summary: Get createdObjects from users
      description: Directory objects that the user created. Read-only. Nullable.
      operationId: user_ListCreatedObject
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
        default:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
  '/users/{user-id}/createdObjects/{directoryObject-id}':
    get:
      tags:
        - users.directoryObject
      summary: Get createdObjects from users
      description: Directory objects that the user created. Read-only. Nullable.
      operationId: user_GetCreatedObject
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: directoryObject-id
          in: path
          description: The unique identifier of directoryObject
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: directoryObject
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.directoryObject'
        default:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  '/users/{user-id}/createdObjects/{directoryObject-id}/microsoft.graph.servicePrincipal':
    get:
      tags:
        - users.directoryObject
      summary: Get the item of type microsoft.graph.directoryObject as microsoft.graph.servicePrincipal
      operationId: user_GetCreatedObjectAsServicePrincipal
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: directoryObject-id
          in: path
          description: The unique identifier of directoryObject
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: directoryObject
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.servicePrincipal'
        default:
          $ref: '#/components/responses/error'
  '/users/{user-id}/createdObjects/$count':
    get:
      tags:
        - users.directoryObject
      summary: Get the number of the resource
      operationId: user.createdObject_GetCount
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        default:
          $ref: '#/components/responses/error'
  '/users/{user-id}/createdObjects/microsoft.graph.servicePrincipal':
    get:
      tags:
        - users.directoryObject
      summary: Get the items of type microsoft.graph.servicePrincipal in the microsoft.graph.directoryObject collection
      operationId: user_ListCreatedObjectAsServicePrincipal
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.servicePrincipalCollectionResponse'
        default:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
  '/users/{user-id}/createdObjects/microsoft.graph.servicePrincipal/$count':
    get:
      tags:
        - users.directoryObject
      summary: Get the number of the resource
      operationId: user.CreatedObject_GetCountAsServicePrincipal
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        default:
          $ref: '#/components/responses/error'
  '/users/{user-id}/directReports':
    get:
      tags:
        - users.directoryObject
      summary: List directReports (for agentUser)
      description: Get an agentUser's direct reports. Returns the users and contacts for whom this agent user is assigned as manager.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/agentuser-list-directreports?view=graph-rest-1.0
      operationId: user_ListDirectReport
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.directoryObjectCollectionResponse'
        default:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
  '/users/{user-id}/directReports/{directoryObject-id}':
    get:
      tags:
        - users.directoryObject
      summary: Get directReports from users
      description: The 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 $expand.
      operationId: user_GetDirectReport
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: directoryObject-id
          in: path
          description: The unique identifier of directoryObject
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: directoryObject
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.directoryObject'
        default:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  '/users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.orgContact':
    get:
      tags:
        - users.directoryObject
      summary: Get the item of type microsoft.graph.directoryObject as microsoft.graph.orgContact
      operationId: user_GetDirectReportAsOrgContact
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: directoryObject-id
          in: path
          description: The unique identifier of directoryObject
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: directoryObject
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.orgContact'
        default:
          $ref: '#/components/responses/error'
  '/users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.user':
    get:
      tags:
        - users.directoryObject
      summary: Get the item of type microsoft.graph.directoryObject as microsoft.graph.user
      operationId: user_GetDirectReportAsUser
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: directoryObject-id
          in: path
          description: The unique identifier of directoryObject
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: directoryObject
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Entity result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.user'
        default:
          $ref: '#/components/responses/error'
  '/users/{user-id}/directReports/$count':
    get:
      tags:
        - users.directoryObject
      summary: Get the number of the resource
      operationId: user.directReport_GetCount
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        default:
          $ref: '#/components/responses/error'
  '/users/{user-id}/directReports/microsoft.graph.orgContact':
    get:
      tags:
        - users.directoryObject
      summary: Get the items of type microsoft.graph.orgContact in the microsoft.graph.directoryObject collection
      operationId: user_ListDirectReportAsOrgContact
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.orgContactCollectionResponse'
        default:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
  '/users/{user-id}/directReports/microsoft.graph.orgContact/$count':
    get:
      tags:
        - users.directoryObject
      summary: Get the number of the resource
      operationId: user.DirectReport_GetCountAsOrgContact
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        default:
          $ref: '#/components/responses/error'
  '/users/{user-id}/directReports/microsoft.graph.user':
    get:
      tags:
        - users.directoryObject
      summary: Get the items of type microsoft.graph.user in the microsoft.graph.directoryObject collection
      operationId: user_ListDirectReportAsUser
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - $ref: '#/components/parameters/top'
        - $ref: '#/components/parameters/skip'
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
        - $ref: '#/components/parameters/count'
        - name: $orderby
          in: query
          description: Order items by property values
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.userCollectionResponse'
        default:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
  '/users/{user-id}/directReports/microsoft.graph.user/$count':
    get:
      tags:
        - users.directoryObject
      summary: Get the number of the resource
      operationId: user.DirectReport_GetCountAsUser
      parameters:
        - name: user-id
          in: path
          description: The unique identifier of user
          required: true
          style: simple
          schema:
            type: string
          x-ms-docs-key-type: user
        - name: ConsistencyLevel
          in: header
          description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
          style: simple
          schema:
            type: string
          examples:
            example-1:
              description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
              value: eventual
        - $ref: '#/components/parameters/search'
        - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        default:
          

# --- truncated at 32 KB (1290 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/_original/azure-ad-graph-users-openapi.yml