Connect Microsoft Graph
Microsoft Graph connects an AI assistant to Microsoft 365: users, groups, licenses, mail, calendars, files, Teams content, devices (Intune), policies, reports and your customers (GDAP and Partner…
Written By Christopher Scaminaci
Last updated About 3 hours ago
Microsoft Graph connects an AI assistant to Microsoft 365: users, groups, licenses, mail, calendars, files, Teams content, devices (Intune), policies, reports and your customers (GDAP and Partner Center orders), in your own directory or in a customer's.
With it your AI can:
- Read users, groups, roles, sign-in and audit logs, service health, devices and your customer list
- Administer (Pro plans) - create and change users and groups, assign licenses, manage devices and policies, send mail on a person's behalf
Set it up
- Open Connectors, then Set up Microsoft.
- Tick Microsoft Graph and any other Microsoft connector you want. One app serves all of them.
- Pick StackJack's app, or one app of your own. The wizard creates it for you, or fixes one you bring.
- Sign in on each connector, then consent your customers in one run.
- Read the checklist. Open the wizard again at any time and it checks again.
Steps and the reasons behind them are on Set up Microsoft. If you prefer a shell, the provisioning script does the app registration without the wizard.
Roles you need
- User Administrator, Groups Administrator and License Administrator for the user, group and license tools
- Intune Administrator for the device tools
- Application Administrator or Cloud Application Administrator in each customer, so StackJack can consent your app there
These are Microsoft's documented minimums.
When something goes wrong
| What you see | What to do |
|---|---|
| A 403 when you preview Authorize all customers | That card's own app cannot read its own registration. The message names the app and gives one link: an administrator of your own directory opens it once, then you run the preview again. |
| Microsoft says admin consent is needed (AADSTS65001) | Open Set up Microsoft, step 3 (your own directory) or step 4 (a customer). |
| Microsoft stops the consent with AADSTS650052 | The directory does not have a service the link asks for. The page that opens after the sign-in says Consent was not granted and shows this code, and Microsoft's message names the service by its application ID. Each link from StackJack asks only for its own connector's permissions, so the service is usually that connector's own, and the directory cannot use that connector (for example, a directory with no Defender). The Purview content search link is the one exception: it asks for every permission on the app, so the directory needs every service the app lists. If the ID is 4990cffe-04e8-4e8b-808a-1175604b879f, it is the Microsoft Partner permission (user_impersonation) on the app. With StackJack's app or your own app, make a fresh consent link in StackJack and send that link. Only the Purview content search link on your own app still needs the removal: remove Microsoft Partner from the API permissions of your app registration in Microsoft Entra, or download the current provisioning script again and run it with -AppId set to your app's application (client) ID. A re-run adds a new client secret, replaces the permission list with the tier you pass (Full if you pass none), and replaces the display name with -DisplayName, so pass the app's current name. Do not remove Microsoft Partner Center; it is a different permission. To consent your own customers without a link, use Authorize all customers on the card. If the message names another service, contact support. |
| Tools ask you to sign in again after a sign-in worked | Your Microsoft cards use more than one app. Open Set up Microsoft and press Move to the one app on the card that differs. |
| A customer returns no data | That customer has not consented yet, or your GDAP relationship lacks the role. Run step 4 again. |
See the generated Microsoft Graph tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.
Microsoft Graph tools
graph_ · 864 tools · Free 481 · Pro 383
Users
| Tool | What it does |
|---|---|
graph_Pro · Write | Assign one or more Microsoft 365 licences to a user. |
graph_Pro · Write | Create a new user account. |
graph_Pro · Destructive | Delete a user account. |
graph_Free · Read-only | Get the profile of the person whose Microsoft sign-in this connection was made with — the account StackJack is acting as. |
graph_Free · Read-only | Get one user account in full, by object id or user principal name (their sign-in address). |
graph_Free · Read-only | Get the person recorded as a user's manager. |
graph_Free · Read-only | List user accounts that have been deleted but are still recoverable. |
graph_Free · Read-only | List users together with their last sign-in and last non-interactive sign-in times — the licence-reclamation and offboarding-audit read. |
graph_Free · Read-only | List the enterprise applications a user has been assigned to, and the role they hold in each. |
graph_Free · Read-only | List the devices registered to a user in the directory — the machines and phones their identity is attached to. |
graph_Free · Read-only | List the people who report to a user. |
graph_Free · Read-only | List the groups, directory roles and administrative units a user belongs to DIRECTLY. |
graph_Free · Read-only | List the Microsoft 365 licences assigned to one user, with the individual service plans inside each and whether each is enabled or switched off. |
graph_Free · Read-only | List the directory objects a user owns — groups, application registrations and service principals. |
graph_Free · Read-only | List every group a user belongs to INCLUDING the ones reached through nested groups — their effective membership. |
graph_Free · Read-only | List the user accounts in an Entra ID (Azure AD) directory — the starting point for almost any question about who works somewhere. |
graph_Pro · Destructive | Permanently remove a deleted user from the directory's recycle bin, ending the 30-day recovery window immediately. |
graph_Pro · Destructive | Remove one or more Microsoft 365 licences from a user. |
graph_Pro · Destructive | Clear the manager relationship on a user, leaving them with none. |
graph_Pro · Destructive | Set a new password on a user account. |
graph_Pro · Write | Restore a user account from the directory's recycle bin, within the 30-day window. |
graph_Pro · Destructive | Invalidate every refresh token and session cookie a user holds, forcing them to sign in again everywhere — browsers, Outlook, Teams, phones. |
graph_Pro · Destructive | Enable or disable a user's account — the standard first step of an offboarding, and the standard containment step for a compromised one. |
graph_Pro · Write | Set or replace the person recorded as a user's manager. |
graph_Pro · Write | Update a user's profile details — display name, job title, department, office, phone numbers, usage location. |
Groups
| Tool | What it does |
|---|---|
graph_Pro · Write | Add a user, device, service principal or another group to a group. |
graph_Pro · Write | Add an owner to a group. |
graph_Pro · Write | Create a security group or a Microsoft 365 group. |
graph_Pro · Destructive | Delete a group. |
graph_Free · Read-only | Get one group in full by object id, including its kind, description, mail address, visibility, expiry date and — for a dynamic group — the membership rule that decides who is in it. |
graph_Free · Read-only | List groups that have been deleted but are still recoverable. |
graph_Free · Read-only | List the enterprise applications a group is assigned to, and the role it holds in each. |
graph_Free · Read-only | List the DIRECT members of a group — the users, other groups, devices and service principals added to it explicitly. |
graph_Free · Read-only | List the groups and directory roles that a GROUP is itself a member of — the upward view of nesting. |
graph_Free · Read-only | List the owners of a group — the people who can manage its membership and settings without being directory administrators. |
graph_Free · Read-only | List everyone who is effectively a member of a group, flattening every level of nesting. |
graph_Free · Read-only | List the groups in an Entra ID directory — security groups, Microsoft 365 groups and distribution lists. |
graph_Pro · Destructive | Permanently remove a deleted group from the recycle bin, ending the 30-day recovery window immediately. |
graph_Pro · Destructive | Remove a member from a group. |
graph_Pro · Destructive | Remove an owner from a group. |
graph_Pro · Write | Renew a Microsoft 365 group, restarting its expiration clock. |
graph_Pro · Write | Restore a group from the directory's recycle bin, within the 30-day window. |
graph_Pro · Write | Update a group's name, description or visibility. |
graph_Pro · Destructive | Change the rule that decides who belongs to a dynamic group. |
Delegated Admin (GDAP)
| Tool | What it does |
|---|---|
graph_Pro · Write | Approve a GDAP relationship that an indirect provider created for you as an indirect reseller. |
graph_Pro · Destructive | Grant one of the partner's security groups a set of administrative roles inside a customer's tenant. |
graph_Pro · Write | Create a GDAP relationship request for a customer. |
graph_Pro · Destructive | Remove an access assignment, revoking that partner group's administrative roles in the customer's tenant. |
graph_Pro · Destructive | Delete a GDAP relationship outright. |
graph_Free · Read-only | Get one GDAP access assignment, naming the partner security group it is built on and the exact customer roles that group receives. |
graph_Free · Read-only | Get one delegated-admin customer by id, with its display name and tenant id. |
graph_Free · Read-only | Get one GDAP relationship in full, including the exact set of Entra role definition ids it grants, its activation and end dates, and whether it auto-extends. |
graph_Free · Read-only | Get one long-running GDAP operation by id and see whether it succeeded, is still running, or failed and why. |
graph_Free · Read-only | Get one GDAP relationship request by id, with the action it carried and its outcome. |
graph_Free · Read-only | List the access assignments on one GDAP relationship — which of the partner's own security groups holds which of the customer's Entra roles. |
graph_Free · Read-only | List the service-management links for one delegated-admin customer — the per-workload administration URLs (Exchange, Teams, SharePoint and the rest) that open that customer's admin centre directly. |
graph_Free · Read-only | List the customers this partner can administer, as the delegated-admin surface sees them. |
graph_Free · Read-only | List the long-running operations on one GDAP relationship. |
graph_Free · Read-only | List the requests raised against one GDAP relationship — the lock-for-approval, approve, reject and terminate actions and how each of them finished. |
graph_Free · Read-only | List every GDAP relationship this partner tenant holds — one per customer per grant, with the roles it carries, its duration and its status. |
graph_Pro · Write | Finalize a draft GDAP relationship and lock it for the customer's approval, moving it from "created" to "approvalPending". |
graph_Pro · Destructive | Reject a pending GDAP relationship that an indirect provider created for you as an indirect reseller. |
graph_Pro · Destructive | End an active GDAP relationship. |
graph_Pro · Destructive | Replace the set of customer roles an existing access assignment grants. |
graph_Pro · Write | Update a GDAP relationship's name, duration, requested roles or auto-extension. |
Licensing
| Tool | What it does |
|---|---|
graph_Pro · Write | Assign licence SKUs to a group, so every member receives them automatically. |
graph_Free · Read-only | Get the licences assigned to a group and the current state of applying them to its members. |
graph_Free · Read-only | Get one purchased SKU in full, including every service plan it contains and each plan's provisioning status. |
graph_Free · Read-only | Get the per-SKU assignment state for one user — where each licence came from, whether it applied cleanly, and the exact error when it did not. |
graph_Free · Read-only | List every licence SKU the tenant has bought, with how many units were purchased, how many are assigned and how many remain. |
graph_Free · Read-only | List everyone assigned a particular licence SKU. |
graph_Pro · Destructive | Remove licence SKUs from a group, which unlicenses every member who was relying on that group for them. |
graph_Pro · Write | Re-evaluate a user's group-based licence assignments. |
Organization & Domains
| Tool | What it does |
|---|---|
graph_Pro · Write | Add a DNS domain to the tenant. |
graph_Pro · Destructive | Remove a domain from the tenant. |
graph_Pro · Destructive | Delete a domain even though objects still reference it, by RENAMING every referencing user and group onto the tenant's initial onmicrosoft.com domain first — and, unless told otherwise, disabling those user accounts. |
graph_Free · Read-only | Get one domain in full. |
graph_Free · Read-only | Get the root domain a subdomain hangs off. |
graph_Free · Read-only | Get the tenant's own organization record — display name, postal address, contact emails, preferred language, default usage location, every verified domain, and the service plans the tenant is entitled to. |
graph_Free · Read-only | Get the company branding applied to the tenant's sign-in experience — background image and colour, banner logo, sign-in page text, username hint and the self-service password reset links. |
graph_Free · Read-only | List the tenant's certificate-based authentication configuration — the trusted certificate authorities that let users sign in with a smart card or client certificate instead of a password. |
graph_Free · Read-only | List the users, groups and applications whose identity references a domain. |
graph_Free · Read-only | Get the DNS records that make Microsoft 365 services actually work on a verified domain — the MX record mail delivery depends on, the SPF TXT record that stops the tenant's own mail being marked as spam, and the CNAME and SRV records Teams and Skype signalling need. |
graph_Free · Read-only | Get the DNS records that must be published in a domain's zone file BEFORE ownership can be verified. |
graph_Free · Read-only | List every DNS domain associated with the tenant, with the four flags that answer most domain questions at a glance: isVerified says whether ownership was proven, isDefault marks the domain new users are created under, isInitial marks the permanent onmicrosoft.com domain Microsoft issued and which can never be deleted, and isRoot distinguishes a root domain from a subdomain. |
graph_Free · Read-only | List the setting templates Entra publishes, each naming the settings it contains, their types and their default values. |
graph_Free · Read-only | List the tenant-wide directory settings currently in force — despite the endpoint's name these are not per-group settings but organization-wide policy, and they are where several answers live that people expect to find elsewhere: whether members may invite guests, whether ordinary users may create Microsoft 365 groups, the group naming and blocked-word policy, and the custom banned password list. |
graph_Free · Read-only | List the per-language overrides of the tenant's sign-in branding. |
graph_Pro · Destructive | Promote a verified subdomain to be a root domain in its own right, so it stops inheriting authentication settings from its parent and carries its own. |
graph_Pro · Write | Update a verified domain's supported services, password policy or default status. |
graph_Pro · Write | Update a tenant-wide directory settings object — guest invitation policy, who may create Microsoft 365 groups, the group naming policy, the banned password list. |
graph_Pro · Write | Update the tenant's organization record — the notification addresses Microsoft uses to reach the customer, the postal address, and the preferred language. |
graph_Pro · Write | Prove ownership of a domain by having Entra look for the verification record in its public DNS. |
Applications & Service Principals
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Add a certificate credential to an app registration, for rolling an expiring certificate without downtime. |
graph_Pro · Write | Add a user as an owner of an app registration. |
graph_Pro · Destructive | Generate a new client secret for an app registration and return its value. |
graph_Pro · Destructive | Add a certificate credential to a service principal, for rolling an expiring certificate. |
graph_Pro · Write | Add a user as an owner of a service principal. |
graph_Pro · Destructive | Generate a new client secret on a service principal and return its value — the same one-time disclosure as the app-registration version, and the same warning: this response is the only time Microsoft ever shows the secret. |
graph_Pro · Write | Register a new application in this directory. |
graph_Pro · Destructive | Consent to delegated permissions for a client application, on behalf of one user or of everyone in the tenant. |
graph_Pro · Write | Create a service principal for an application in this directory — giving an existing app registration an identity here so it can sign in and be assigned access. |
graph_Pro · Destructive | Delete an app registration into the 30-day recycle bin, where it can be restored with its object id, client id and credentials intact. |
graph_Pro · Destructive | Revoke a delegated permission grant entirely. |
graph_Pro · Destructive | Delete an application's identity in this tenant, taking its consent grants and role assignments with it. |
graph_Free · Read-only | Get one app registration in full: its redirect URIs, the API permissions it requests, its credentials and their expiry dates, and whether it is single- or multi-tenant. |
graph_Free · Read-only | Get one service principal in full — an application's identity inside this specific tenant. |
graph_Pro · Destructive | Assign an app role on a resource application to a user, group or service principal. |
graph_Free · Read-only | List the owners of an app registration — the people who can change it, add credentials to it and consent on its behalf without holding any directory role. |
graph_Free · Read-only | List the app registrations defined in this directory — the applications the tenant itself owns, not the third-party apps it merely uses. |
graph_Free · Read-only | List every delegated permission grant in the directory — the tenant-wide consent inventory. |
graph_Free · Read-only | List app registrations in the 30-day recycle bin. |
graph_Free · Read-only | List the app-role assignments made ON this service principal — who has been given a role in this application. |
graph_Free · Read-only | List the app-role assignments GRANTED TO this service principal — the application permissions it holds against other APIs, such as Mail.Read or Directory.ReadWrite.All over the whole tenant. |
graph_Free · Read-only | List the delegated permission grants for one client application — what it may do on behalf of a signed-in user. |
graph_Free · Read-only | List the owners of a service principal. |
graph_Free · Read-only | List the service principals in a directory — every application that has an identity in this tenant, including Microsoft's own first-party services and every third-party app anyone has consented to. |
graph_Pro · Destructive | Permanently remove a deleted app registration from the recycle bin. |
graph_Pro · Destructive | Remove a certificate credential from an app registration. |
graph_Pro · Destructive | Remove an owner from an app registration. |
graph_Pro · Destructive | Delete a client secret from an app registration by its keyId. |
graph_Pro · Destructive | Remove a certificate credential from a service principal. |
graph_Pro · Destructive | Remove an owner from a service principal. |
graph_Pro · Destructive | Delete a client secret from a service principal by its keyId. |
graph_Pro · Write | Restore an app registration from the 30-day recycle bin. |
graph_Pro · Destructive | Remove an app-role assignment, revoking that access. |
graph_Pro · Destructive | Turn an application's sign-in on or off in this tenant. |
graph_Pro · Write | Update an app registration's properties. |
graph_Pro · Destructive | Replace the scopes on an existing delegated permission grant. |
graph_Pro · Write | Update a service principal's local properties — its display name in this tenant, its notes, its home-page URL, its tags. |
Directory Roles & PIM
| Tool | What it does |
|---|---|
graph_Pro · Write | Activate a directory role in this tenant from its template, creating the role object so members can be added to it. |
graph_Pro · Destructive | Activate a role the signed-in user is already eligible for — the just-in-time elevation at the centre of Privileged Identity Management. |
graph_Pro · Destructive | Add a user, group or service principal to a directory role, granting that role's administrative permissions permanently and immediately. |
graph_Pro · Destructive | Assign a directory role through Privileged Identity Management with a time limit — an ACTIVE grant that expires on its own. |
graph_Pro · Destructive | Create a unified RBAC role assignment — the way to grant a role SCOPED to part of the directory rather than all of it. |
graph_Pro · Write | Create a custom directory role from a set of resource actions. |
graph_Pro · Write | Give up a role the signed-in user activated, before it expires on its own. |
graph_Pro · Destructive | Remove a unified RBAC role assignment, revoking those permissions immediately. |
graph_Pro · Destructive | Delete a custom role definition. |
graph_Free · Read-only | Get one activated directory role by its object id, including the roleTemplateId that identifies WHICH Entra role it is. |
graph_Free · Read-only | Get one role definition with its full permission set. |
graph_Free · Read-only | Get one PIM policy, expanding its rules — which is where the settings that matter actually live. |
graph_Free · Read-only | List who holds a directory role. |
graph_Free · Read-only | List every directory role Entra defines, whether or not this tenant has ever used one. |
graph_Free · Read-only | List the directory roles that are ACTIVE in this tenant. |
graph_Free · Read-only | List the role assignments in effect right NOW — the closest thing this API offers to "who is an administrator at this moment". |
graph_Free · Read-only | List the requests that assigned, activated, extended or removed role assignments — the PIM audit trail, including every self-activation with the justification the person typed. |
graph_Free · Read-only | List the scheduled role ASSIGNMENTS — active grants managed through Privileged Identity Management, including the ones with an expiry date. |
graph_Free · Read-only | List unified RBAC role assignments — the permanent grants, including the SCOPED ones that the directory-role member listing cannot express. |
graph_Free · Read-only | List the unified RBAC role definitions — every built-in Entra role plus any custom roles this tenant has defined, each with the exact permissions it carries in rolePermissions. |
graph_Free · Read-only | List the role eligibilities that are in effect right NOW, as opposed to the schedules that define them. |
graph_Free · Read-only | List the requests that created, changed or removed role eligibilities — the audit trail for who was made eligible for what, by whom, and with what justification. |
graph_Free · Read-only | List who is ELIGIBLE for a directory role — the people who can elevate themselves into it whenever they choose, without asking anyone. |
graph_Free · Read-only | List the Privileged Identity Management policies for directory roles — the rules that decide how elevation actually works: whether approval is required, whether multifactor authentication is enforced at activation, how long an activation lasts, and who gets notified. |
graph_Free · Read-only | List which PIM policy applies to which role. |
graph_Pro · Destructive | Make a user or group ELIGIBLE for a directory role through Privileged Identity Management — they hold nothing until they activate, and can activate whenever they choose subject to the role's PIM policy. |
graph_Pro · Destructive | Remove a member from a directory role, revoking those administrative permissions immediately. |
graph_Pro · Destructive | Remove someone's eligibility for a directory role, so they can no longer elevate into it. |
graph_Pro · Destructive | Remove a role assignment that was made through Privileged Identity Management, revoking it immediately rather than waiting for it to expire. |
graph_Pro · Destructive | Update a custom role definition. |
Authentication Methods
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Register an email address on an account for self-service password reset. |
graph_Pro · Destructive | Register a phone number for multifactor authentication on an account. |
graph_Pro · Destructive | Issue a Temporary Access Pass for a user and RETURN THE PASSCODE. |
graph_Pro · Destructive | Revoke a Temporary Access Pass immediately, before it expires on its own. |
graph_Pro · Destructive | Remove a Microsoft Authenticator registration from an account — the standard lost-phone and replaced-phone action. |
graph_Pro · Destructive | Remove an email address from an account's password-reset methods. |
graph_Pro · Destructive | Remove a FIDO2 security key from an account. |
graph_Pro · Destructive | Remove a phone number from an account's authentication methods. |
graph_Pro · Destructive | Remove a third-party authenticator (software OATH) token from an account. |
graph_Pro · Destructive | Remove a Windows Hello for Business registration from an account. |
graph_Pro · Destructive | Stop a user signing in with an SMS code, leaving the number registered as a second factor. |
graph_Pro · Destructive | Allow a user to sign IN with a code sent to their registered mobile number, rather than only using it as a second factor. |
graph_Free · Read-only | Get the tenant's authentication methods policy — which methods are permitted, and for whom. |
graph_Free · Read-only | List every user's authentication-method registration status in one report — who is registered for multifactor authentication, who is capable of self-service password reset, and which methods each has. |
graph_Free · Read-only | List every authentication method registered on one account, of every type, in a single call. |
graph_Free · Read-only | List the Microsoft Authenticator registrations on an account, including the device each one is installed on. |
graph_Free · Read-only | List the email addresses registered on an account for self-service password reset. |
graph_Free · Read-only | List the FIDO2 security keys registered on an account, with each key's model and the display name its owner gave it. |
graph_Free · Read-only | List the phone numbers registered for multifactor authentication on one account, each with its type — mobile, alternateMobile or office. |
graph_Free · Read-only | List the third-party authenticator (software OATH) tokens registered on an account — the codes generated by apps other than Microsoft Authenticator. |
graph_Free · Read-only | List the Temporary Access Passes on an account, with each one's lifetime, whether it is single-use, and whether it is currently usable. |
graph_Free · Read-only | List the Windows Hello for Business registrations on an account — the PIN or biometric sign-in bound to a specific device. |
graph_Pro · Destructive | Ask Entra to generate a new password for a user and RETURN IT. |
graph_Pro · Destructive | Turn an authentication method on or off for the whole tenant, or restrict it to particular groups. |
graph_Pro · Destructive | Update the tenant-wide authentication methods policy — the settings that sit above the individual methods, most usefully the registration campaign that nudges users onto the Authenticator app and the policy's migration state. |
graph_Pro · Destructive | Change the number on an existing phone authentication method — the ordinary fix when somebody changes handset or carrier. |
Conditional Access
| Tool | What it does |
|---|---|
graph_Pro · Write | Define an authentication context — one of the c1 to c25 labels an application can request to force step-up authentication on a specific action. |
graph_Pro · Write | Define a custom authentication strength — a named set of method combinations that a Conditional Access policy can require. |
graph_Pro · Destructive | Create a Conditional Access policy. |
graph_Pro · Write | Define a named location from a list of countries, for policies to refer to by name. |
graph_Pro · Write | Define a named location from IP ranges, for policies to refer to by name. |
graph_Pro · Destructive | Delete an authentication context. |
graph_Pro · Destructive | Delete a custom authentication strength policy. |
graph_Pro · Destructive | Delete a Conditional Access policy permanently. |
graph_Pro · Destructive | Delete a named location. |
graph_Free · Read-only | Get one authentication strength policy with its allowedCombinations — the exact method combinations that satisfy it. |
graph_Free · Read-only | Get one Conditional Access policy in full. |
graph_Free · Read-only | Get one named location with its full definition. |
graph_Free · Read-only | List the authentication context class references — the c1 to c25 labels that let an application ask for step-up authentication on a specific action rather than at sign-in. |
graph_Free · Read-only | List the authentication strength policies — the named combinations of methods a Conditional Access policy can demand, such as Microsoft's built-in phishing-resistant MFA. |
graph_Free · Read-only | List every Conditional Access policy in the tenant with its conditions and grant controls. |
graph_Free · Read-only | List the named locations defined in the tenant — the IP ranges and countries that Conditional Access policies refer to by name. |
graph_Pro · Destructive | Turn a Conditional Access policy on, off, or into report-only mode. |
graph_Pro · Destructive | Update a Conditional Access policy's conditions or controls. |
graph_Pro · Destructive | Update a named location's ranges, countries or trusted flag. |
Administrative Units
| Tool | What it does |
|---|---|
graph_Pro · Write | Add a user, group or device to an administrative unit. |
graph_Pro · Destructive | Grant somebody an administrative role limited to this unit's members. |
graph_Pro · Write | Create an administrative unit. |
graph_Pro · Destructive | Delete an administrative unit. |
graph_Free · Read-only | Get one administrative unit, including its membership rule if it has one and its visibility. |
graph_Free · Read-only | List the users, groups and devices inside an administrative unit. |
graph_Free · Read-only | List who holds an administrative role SCOPED to this unit — the people who can administer its members and nobody else. |
graph_Free · Read-only | List the administrative units in a directory — the containers that let administrative power be scoped to part of the tenant rather than all of it. |
graph_Pro · Destructive | Remove a user, group or device from an administrative unit. |
graph_Pro · Destructive | Revoke somebody's administrative role over this unit. |
graph_Pro · Write | Update an administrative unit's name, description or visibility. |
graph_Pro · Destructive | Change the membership rule of a dynamic administrative unit. |
Devices
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Register a user as an OWNER of a device. |
graph_Pro · Write | Register a user on a device — the record that this person uses this machine. |
graph_Pro · Destructive | Delete a device object from the directory. |
graph_Free · Read-only | Get one device object in full — operating system and version, join and trust type, management authority, compliance flag and when it last signed in. |
graph_Free · Read-only | List the groups and administrative units a device belongs to DIRECTLY. |
graph_Free · Read-only | List the registered OWNERS of a device — normally the person who joined it to the directory. |
graph_Free · Read-only | List the users registered on a device — everyone who has signed in and established a device registration, which on a shared machine is a longer list than anyone expects. |
graph_Free · Read-only | List every group and administrative unit a device belongs to, INCLUDING through nesting. |
graph_Free · Read-only | List the devices registered in a directory. |
graph_Pro · Destructive | Remove a user's OWNER registration on a device — the inverse of adding one, and destructive because it withdraws the local administrator rights an Entra-joined Windows machine grants its registered owner. |
graph_Pro · Destructive | Remove a user's registration on a device. |
graph_Pro · Destructive | Enable or disable a device's directory account. |
graph_Pro · Write | Update a device object's descriptive properties — its display name, operating system and version. |
Intune Devices
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Remove Apple's Activation Lock from a supervised device so it can be set up under a different Apple Account. |
graph_Pro · Destructive | Reset a Windows device to its factory settings, the 'Autopilot Reset / fresh start' action. |
graph_Pro · Write | Create an Intune device category. |
graph_Pro · Destructive | Delete an Intune device category. |
graph_Pro · Destructive | Delete a device's RECORD from Intune. |
graph_Pro · Destructive | Remove one named user's account and cached data from a shared iPad. |
graph_Pro · Destructive | Turn off Lost Mode on a supervised Apple device, returning it to ordinary use and ending the location tracking that Lost Mode enables. |
graph_Free · Read-only | Get one detected application — its display name, version, publisher, size and the number of devices reporting it. |
graph_Free · Read-only | Get one Intune device category by id — its display name and description. |
graph_Free · Read-only | Get one Intune-managed device in full — hardware, operating system, storage, compliance and encryption state, enrolment details and the results of any remote actions already sent to it (deviceActionResults). |
graph_Free · Read-only | Get the device category assigned to one Intune-managed device. |
graph_Free · Read-only | Get the Microsoft Defender protection state of a Windows device — real-time protection status, network inspection, signature version and age, malware protection enablement, last quick and full scan times, and whether a reboot is required to finish remediation. |
graph_Free · Read-only | List the managed devices reporting a particular detected application. |
graph_Free · Read-only | List the applications Intune has DETECTED across the enrolled fleet, with a device count for each. |
graph_Free · Read-only | List the Intune device categories defined in a tenant. |
graph_Free · Read-only | List the diagnostic log collection requests raised against an Intune-managed device, with each request's status, size, the time it was requested and when it expires. |
graph_Free · Read-only | List the primary users associated with an Intune-managed device. |
graph_Free · Read-only | List the devices enrolled in Intune. |
graph_Pro · Write | Ask a supervised iOS/iPadOS or macOS device to report its location. |
graph_Pro · Destructive | Sign out whoever is currently signed in on a shared iPad. |
graph_Pro · Destructive | Restart a device now. |
graph_Pro · Destructive | Ask a supervised device to surrender its current passcode to Intune. |
graph_Pro · Destructive | Lock a device remotely so it requires its passcode to be used again. |
graph_Pro · Write | Request a remote-assistance session for a device. |
graph_Pro · Destructive | Remove or reset the passcode on a device. |
graph_Pro · Destructive | Unenrol a device from Intune, removing company data, policies, certificates, Wi-Fi and VPN profiles and company applications while leaving the person's own data in place. |
graph_Pro · Destructive | Power a device off immediately. |
graph_Pro · Write | Ask a device to check in with Intune immediately rather than waiting for its scheduled cycle. |
graph_Pro · Write | Update an Intune device category's name or description. |
graph_Pro · Write | Update the two properties Intune lets an administrator write on a managed device: managedDeviceName, the friendly name shown throughout the console, and notes. |
graph_Pro · Write | Start a Microsoft Defender scan on a Windows device. |
graph_Pro · Write | Tell a Windows device to update its Microsoft Defender malware signatures now. |
graph_Pro · Destructive | FACTORY-RESET a device. |
Intune Configuration
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Set which groups a compliance policy applies to. |
graph_Pro · Destructive | Set which groups a configuration profile applies to. |
graph_Pro · Write | Create an Intune compliance policy. |
graph_Pro · Write | Create an Intune configuration profile. |
graph_Pro · Destructive | Delete an Intune compliance policy. |
graph_Pro · Destructive | Delete an Intune configuration profile. |
graph_Free · Read-only | Get the device-level summary for a compliance policy — compliant, non-compliant, error, conflict, not-applicable and pending counts in one object. |
graph_Free · Read-only | Get one Intune compliance policy in full, with every rule it evaluates. |
graph_Free · Read-only | Get the user-level summary for a compliance policy — the same verdict counts aggregated by person rather than by machine. |
graph_Free · Read-only | Get one Intune configuration profile in full, including every setting it carries. |
graph_Free · Read-only | Get the device-level rollout summary for a configuration profile — the counts of succeeded, error, conflict, not-applicable and pending devices in one small object. |
graph_Free · Read-only | Get the user-level rollout summary for a configuration profile — succeeded, error, conflict, not-applicable and pending counted by PERSON rather than by machine. |
graph_Pro · Destructive | Return the PLAIN-TEXT SECRET behind an encrypted OMA-URI setting in a Windows custom configuration profile — typically a VPN pre-shared key, a Wi-Fi passphrase or a certificate password. |
graph_Free · Read-only | List each targeted device's verdict against a compliance policy, with the device name and when it last reported. |
graph_Free · Read-only | List the Intune device compliance policies in a tenant — the policies that MEASURE whether a device meets the rules, as opposed to configuration profiles, which set them. |
graph_Free · Read-only | List the groups a compliance policy is assigned to, including exclusions. |
graph_Free · Read-only | List the scheduled actions attached to a compliance policy — what Intune does when a device fails, and how long it waits first. |
graph_Free · Read-only | List each targeted user's aggregated verdict against a compliance policy. |
graph_Free · Read-only | List the groups a configuration profile is assigned to, including whether each assignment INCLUDES or EXCLUDES that group. |
graph_Free · Read-only | List how a configuration profile landed on each targeted DEVICE — succeeded, pending, error or conflict, with the device name and the time it last reported. |
graph_Free · Read-only | List how a configuration profile landed for each targeted USER, aggregated across all of that person's devices. |
graph_Free · Read-only | List the Intune device configuration profiles in a tenant: the profiles that SET things on devices, as opposed to compliance policies, which measure them. |
graph_Pro · Write | Update an Intune compliance policy. |
graph_Pro · Write | Update an Intune configuration profile. |
Intune Settings Catalog and Endpoint Security
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Set who a settings catalog or endpoint security policy applies to. |
graph_Pro · Destructive | Set who an Intune intent applies to. |
graph_Free · Read-only | Get one settings catalog or endpoint security policy with its settings and assignments expanded: what it sets, and who it reaches. |
graph_Free · Read-only | Get one Intune intent with its settings and assignments expanded: what it sets, and who it reaches. |
graph_Free · Read-only | Collect a report started with graph_start_device_policy_report. |
graph_Free · Read-only | List the Intune policies built in the settings catalog or from an endpoint security template, the ones graph_list_device_configurations cannot see. |
graph_Free · Read-only | List who one settings catalog or endpoint security policy is assigned to. |
graph_Free · Read-only | List the settings inside one settings catalog or endpoint security policy. |
graph_Free · Read-only | List who one Intune intent is assigned to. |
graph_Free · Read-only | List the settings of one Intune intent. |
graph_Free · Read-only | List the Intune intents: the endpoint security policies created from the older security baseline and template surface, which graph_list_configuration_policies does not return. |
graph_Free · Read-only | Start the report of which configuration policies Intune has applied to one managed device, with each policy's status. |
Mobility Management
| Tool | What it does |
|---|---|
graph_Free · Read-only | List a tenant's automatic enrollment policies, with includedGroups expanded: the Windows Automatic Enrollment settings. |
graph_Pro · Destructive | Change an MDM automatic enrollment policy: who it applies to, which groups it includes, and whether users are prompted to enroll a Microsoft Entra registered device. |
Identity Protection
| Tool | What it does |
|---|---|
graph_Pro · Write | Tell Entra ID Protection that these accounts really were compromised, setting each to confirmedCompromised at high risk. |
graph_Pro · Write | Dismiss the risk on these accounts, setting each to dismissed at none. |
graph_Free · Read-only | Get one risk detection event in full — the detection type and its source, the IP address and resolved location, the client application, and the sign-in or user it was raised against. |
graph_Free · Read-only | Get one account's current risk verdict — level, state, detail and when it was last updated. |
graph_Free · Read-only | List individual risk detection events — one row per thing Microsoft noticed, with the detection type, the IP address, the location and the activity it was attached to. |
graph_Free · Read-only | List how one account's risk state changed over time — every transition, what caused it, and the activity behind it. |
graph_Free · Read-only | List the accounts Entra ID Protection currently considers at risk. |
Audit Logs
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get one directory audit event in full — the initiator, the category and result, and the targetResources array with the OLD and NEW values of every property that changed. |
graph_Free · Read-only | Get one sign-in event in full — the account and application, the client and device, the resolved location, the authentication methods that were satisfied, and every Conditional Access policy that was evaluated with the decision each reached. |
graph_Free · Read-only | List directory audit events — every administrative change made in the tenant, with who made it, what it targeted and whether it succeeded. |
graph_Free · Read-only | List provisioning events — what Entra's provisioning service synchronised into or out of a connected application, per object, with the outcome and the reason for it. |
graph_Free · Read-only | List sign-in events — who signed in, when, from which IP address and location, on what device, to which application, and whether it succeeded. |
Directory Objects
| Tool | What it does |
|---|---|
graph_Free · Read-only | Given a directory object and a list of group, role or administrative-unit ids, return the SUBSET it actually belongs to — transitively. |
graph_Pro · Destructive | Invite an external person into the directory as a B2B guest. |
graph_Free · Read-only | List the directory extension properties defined in this tenant — the custom fields an organization or a synchronisation tool has added to users, groups, devices or applications. |
graph_Free · Read-only | Get any directory object by its id without knowing what type it is. |
graph_Free · Read-only | Resolve many object ids to their directory objects in ONE call. |
graph_Free · Read-only | Return the ids of every GROUP a directory object belongs to, including through nesting. |
graph_Free · Read-only | Return the ids of every group, DIRECTORY ROLE and administrative unit a directory object belongs to, including through nesting. |
Security
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get one Secure Score snapshot in full, including controlScores — the per-control detail saying what each control contributed on that day and why. |
graph_Free · Read-only | Get one Secure Score control definition in full — its title and category, the maximum score it can contribute, the threats it addresses, its user impact and implementation cost, and the remediation text. |
graph_Free · Read-only | Get one Defender XDR alert in full — the detection and its source, the incident it belongs to, and the evidence array naming the devices, accounts, files, processes and URLs involved. |
graph_Free · Read-only | Get one Defender XDR incident — its severity, status, assigned owner, classification and determination, plus the tags and comments analysts have added. |
graph_Free · Read-only | List Microsoft Purview Insider Risk Management alerts: the alerts_v2 collection filtered to serviceSource microsoftInsiderRiskManagement, requested with the Prefer: include-unknown-enum-members header so each row's serviceSource names Insider Risk Management (Graph's guidance is that without it newer sources read unknownFutureValue). |
graph_Free · Read-only | List the Secure Score control definitions — what each control is, which service it belongs to, what it is worth, the user impact of turning it on and the remediation steps. |
graph_Free · Read-only | List Microsoft Secure Score snapshots — one per day, each with the tenant's score out of the maximum and the per-control breakdown behind it. |
graph_Free · Read-only | List Defender XDR alerts — individual detections from Defender for Endpoint, Office 365, Identity and Cloud Apps. |
graph_Free · Read-only | List the alerts Defender correlated into one incident — the evidence behind the story. |
graph_Free · Read-only | List Defender XDR incidents — correlated groups of alerts, which is the right unit to triage from. |
graph_Free · Read-only | Run a Kusto Query Language (KQL) query against Microsoft Defender's advanced hunting schema — raw event data across devices, email, identities and cloud apps, going back 30 days by default. |
graph_Pro · Write | Record a tenant's own position on a Secure Score control — Default, Ignored, ThirdParty or Reviewed — with an optional note. |
graph_Pro · Write | Update an alert's status, classification, determination or assigned owner. |
graph_Pro · Write | Update an incident's status, classification, determination, assigned owner or display name. |
Purview Labels
| Tool | What it does |
|---|---|
graph_Pro · Write | Create a Microsoft Purview retention label. |
graph_Pro · Destructive | Delete a Microsoft Purview retention label permanently. |
graph_Free · Read-only | Get one Microsoft Purview retention label. |
graph_Free · Read-only | Get one sensitivity label by id. |
graph_Free · Read-only | List the tenant's Microsoft Purview retention labels: what each keeps (behaviorDuringRetentionPeriod), for how long (retentionDuration), from when (retentionTrigger), what happens at the end (actionAfterRetentionPeriod) and whether it is in use (isInUse). |
graph_Free · Read-only | List the sensitivity labels available in the tenant: name, displayName, description, color, tooltip, sensitivity and priority, isEnabled, hasProtection, applicableTo (email, site and so on) and isScopedToUser. |
graph_Pro · Destructive | Update a Microsoft Purview retention label. |
Usage Reports
| Tool | What it does |
|---|---|
graph_Free · Read-only | Tenant-wide email totals per day — messages sent, received and read across the whole organization. |
graph_Free · Read-only | Per-user email activity — send, receive and read counts, and each mailbox's last activity date. |
graph_Free · Read-only | Which email CLIENTS each user actually connects with — Outlook desktop, Outlook mobile, Outlook Web, IMAP, POP, SMTP. |
graph_Free · Read-only | Daily counts of users active on each PLATFORM — Windows, Mac, mobile and web. |
graph_Free · Read-only | Daily counts of users active in each Microsoft 365 app across the tenant. |
graph_Free · Read-only | Per-user Microsoft 365 Apps usage broken down by application AND platform — Word, Excel, Outlook, Teams and the rest, on Windows, Mac, mobile and web. |
graph_Free · Read-only | Per-mailbox storage — bytes used against the quota, item count, and quota status. |
graph_Free · Read-only | Total mailbox storage consumed across the tenant, per day. |
graph_Free · Read-only | Office activation totals per product and platform across the tenant — how many activations exist for each, rather than who holds them. |
graph_Free · Read-only | Per-user desktop Office activations — which platforms each person has activated on (Windows, Mac, iOS, Android) and whether it was a shared computer. |
graph_Free · Read-only | Daily counts of active users per service across the tenant. |
graph_Free · Read-only | The single most useful report here: one row per user, with which products they are LICENSED for and their last activity date in EACH — Exchange, OneDrive, SharePoint, Teams, Yammer. |
graph_Free · Read-only | Enabled versus ACTIVE user counts per service — how many people are licensed for each product against how many actually used it. |
graph_Free · Read-only | Per-user OneDrive activity — files viewed or edited, synced, shared internally and shared EXTERNALLY. |
graph_Free · Read-only | Per-account OneDrive storage — files, active files, bytes used against bytes allocated, and last activity. |
graph_Free · Read-only | Per-user SharePoint activity — files viewed or edited, synced, shared internally and externally, and pages visited. |
graph_Free · Read-only | Per-SITE SharePoint usage — storage used and allocated, file and page counts, visitors, and last activity. |
graph_Free · Read-only | Which DEVICES each person uses Teams from — Windows, Mac, iOS, Android, web and Linux. |
graph_Free · Read-only | Tenant-wide Teams totals per day — messages, meetings and calls across the organization. |
graph_Free · Read-only | Per-user Teams activity — channel messages, chat messages, meetings attended and organised, and calls. |
graph_Free · Read-only | Per-user Viva Engage (formerly Yammer) activity — messages posted, read and liked, with last activity date. |
| Tool | What it does |
|---|---|
graph_Pro · Write | Copy a message into another folder, leaving the original where it is. |
graph_Pro · Write | Create a message in the Drafts folder without sending it. |
graph_Pro · Write | Create a forward DRAFT of a message, with its attachments, without sending it. |
graph_Pro · Write | Create a mail folder, either at the top level or beneath an existing folder. |
graph_Pro · Destructive | Create a rule on the signed-in user's Inbox. |
graph_Pro · Write | Create a reply DRAFT to a message — correctly threaded and addressed, quoting the original — without sending it. |
graph_Pro · Destructive | Delete a mail folder AND EVERYTHING IN IT, including its subfolders and every message they hold. |
graph_Pro · Destructive | Delete a message. |
graph_Pro · Destructive | Delete an inbox rule permanently — there is no undo and no copy kept. |
graph_Free · Read-only | Download an attachment's raw bytes and return a short-lived read-only download link, together with the content type, filename and size. |
graph_Pro · Destructive | Forward a message, with its attachments, to new recipients and send it immediately. |
graph_Free · Read-only | Get one mail folder by id or by well-known name. |
graph_Free · Read-only | Get the signed-in user's mailbox settings — automatic replies (out-of-office) and their schedule, time zone, working hours, language, date and time format, and how delegated meeting messages are handled. |
graph_Free · Read-only | Get one message in full, including its body and internet headers. |
graph_Free · Read-only | Get one attachment as JSON. |
graph_Free · Read-only | Get one inbox rule in full. |
graph_Free · Read-only | List the folders directly beneath one mail folder. |
graph_Free · Read-only | List the signed-in user's master list of Outlook categories — the coloured labels shared across messages, events, contacts and tasks. |
graph_Free · Read-only | List the messages inside one mail folder, by folder id or well-known name. |
graph_Free · Read-only | List the top-level mail folders in the signed-in user's mailbox, with unread and total item counts. |
graph_Free · Read-only | List a message's attachments as METADATA — name, content type and size — without pulling any content down. |
graph_Free · Read-only | List every rule on the signed-in user's INBOX, with its conditions, actions and exceptions. |
graph_Free · Read-only | List messages in the signed-in user's mailbox, newest first unless you order them otherwise. |
graph_Pro · Write | Move a message to another folder, by folder id or well-known name such as "archive", "junkemail" or "deleteditems". |
graph_Pro · Destructive | Reply to EVERYONE on a message — sender, To and CC — and send it immediately. |
graph_Pro · Destructive | Reply to a message's SENDER only and send it immediately. |
graph_Free · Read-only | Free-text search across the signed-in user's mailbox, including message bodies and the text of supported attachment types. |
graph_Pro · Destructive | Send a draft that already exists in the mailbox. |
graph_Pro · Destructive | Send a message immediately AS THE SIGNED-IN USER, from their real address. |
graph_Pro · Write | Turn the signed-in user's out-of-office automatic reply on, off, or on for a scheduled window. |
graph_Pro · Write | Rename a mail folder. |
graph_Pro · Write | Update a message's mutable properties — read state, importance and categories. |
graph_Pro · Destructive | Change an existing inbox rule. |
Files
| Tool | What it does |
|---|---|
graph_Pro · Write | Copy a file or folder, optionally into a different drive and optionally under a new name. |
graph_Pro · Write | Create a folder, in the drive's root or inside an existing folder. |
graph_Pro · Destructive | Create a sharing link for a file or folder and RETURN THE URL. |
graph_Pro · Destructive | Delete a file or folder. |
graph_Pro · Destructive | Remove a permission from a file or folder — the remediation for an oversharing finding, and the way an anonymous link is killed. |
graph_Free · Read-only | Download a file's content and return a short-lived read-only download link, with its content type, filename and size. |
graph_Free · Read-only | Get one drive, including its quota — total, used, remaining and the deleted bytes still held in the recycle bin. |
graph_Free · Read-only | Get one file or folder by id — size, timestamps, the person who last changed it, and the webUrl that opens it in a browser for someone who already has access. |
graph_Free · Read-only | Get a file or folder by its path within the drive, for example "Documents/Invoices/2026-Q3.xlsx". |
graph_Pro · Destructive | Grant named people access to a file or folder, optionally emailing them an invitation. |
graph_Free · Read-only | List the stored versions of a file, newest first, with who saved each one and how large it was. |
graph_Free · Read-only | List the files and folders directly inside one folder, or inside the drive's root when no folder is named. |
graph_Free · Read-only | List drives — the signed-in user's own OneDrive by default, or every document library belonging to a SharePoint site or a Microsoft 365 group when you name one. |
graph_Free · Read-only | List everyone and everything that can reach a file or folder — people granted access directly, permissions inherited from a parent folder, and every sharing link that exists on it. |
graph_Free · Read-only | List the files the signed-in user most recently viewed or edited, across every drive they can reach rather than one at a time. |
graph_Free · Read-only | List files and folders other people have shared with the signed-in user. |
graph_Pro · Write | Move a file or folder to a different folder in the SAME drive, optionally renaming it on the way. |
graph_Pro · Write | Rename a file or folder. |
graph_Pro · Write | Restore a previous version of a file, making it the current content. |
graph_Free · Read-only | Search a drive for files and folders matching a term, across the whole hierarchy rather than one folder. |
graph_Pro · Destructive | Change an existing permission's roles or expiry — turning read access into write, or putting an expiry on a link that has none. |
Calendar
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Cancel a meeting the signed-in user ORGANISED, sending a cancellation notice to every attendee. |
graph_Pro · Write | Create an additional calendar for the signed-in user. |
graph_Pro · Destructive | Share a calendar with somebody, choosing how much they can see. |
graph_Pro · Destructive | Create an event. |
graph_Pro · Destructive | Delete a calendar AND EVERY EVENT IN IT. |
graph_Pro · Destructive | Remove somebody's access to a calendar — the remediation when an audit finds a share that should not exist. |
graph_Pro · Destructive | Delete an event from the signed-in user's calendar. |
graph_Free · Read-only | Download an event attachment's raw bytes and return a short-lived read-only download link, with its content type, filename and size. |
graph_Pro · Destructive | Forward a meeting invitation to additional people, who receive a real invitation and appear to the organiser as attendees. |
graph_Free · Read-only | Get one calendar, or the signed-in user's default calendar when no id is given. |
graph_Free · Read-only | Get one event in full — attendees and each person's response status, the organiser, location, body, online-meeting join details and, for a series, its recurrence rule. |
graph_Free · Read-only | Get free/busy availability for one or more people, distribution lists, or bookable resources such as meeting rooms, over a time window. |
graph_Free · Read-only | List who a calendar is shared with and how much each of them can see. |
graph_Free · Read-only | List the events occurring between two times, with recurring series EXPANDED into their individual occurrences. |
graph_Free · Read-only | List the signed-in user's calendars — their default one plus any extra calendars they created or had shared with them. |
graph_Free · Read-only | List an event's attachments as metadata — name, content type and size — without pulling any content down. |
graph_Free · Read-only | List the individual occurrences of ONE recurring series within a date range, including any that were moved or cancelled separately from the rest. |
graph_Free · Read-only | List events as they are STORED, which means a recurring series comes back as a single master entry carrying its recurrence rule rather than as its occurrences. |
graph_Pro · Destructive | Answer a meeting invitation as the signed-in user — accept, decline, or accept tentatively. |
graph_Pro · Write | Rename a calendar or change the colour Outlook shows it in. |
graph_Pro · Destructive | Change an event. |
Contacts
| Tool | What it does |
|---|---|
graph_Pro · Write | Add a contact to the signed-in user's personal address book, optionally inside a folder. |
graph_Pro · Destructive | Delete a contact from the signed-in user's personal address book. |
graph_Free · Read-only | Get one personal contact in full — every email address and phone number on the record, the postal addresses, job title and company, and any personal notes. |
graph_Free · Read-only | Get one organizational contact from the directory. |
graph_Free · Read-only | List the contacts inside one contact folder. |
graph_Free · Read-only | List the folders the signed-in user files contacts into. |
graph_Free · Read-only | List the signed-in user's personal Outlook contacts — their own private address book, not the organisation's shared directory. |
graph_Free · Read-only | List the tenant's ORGANIZATIONAL contacts — the shared directory entries everyone in the organisation sees in the global address list, typically outside accountants, suppliers and contractors who have no mailbox of their own. |
graph_Pro · Write | Change a personal contact. |
SharePoint
| Tool | What it does |
|---|---|
graph_Pro · Write | Create a new list in a SharePoint site. |
graph_Pro · Write | Add a column to a SharePoint list. |
graph_Pro · Write | Add a row to a SharePoint list. |
graph_Pro · Destructive | Delete a SharePoint list AND EVERY ITEM IN IT. |
graph_Pro · Destructive | Remove a column from a SharePoint list. |
graph_Pro · Destructive | Delete one row from a SharePoint list. |
graph_Free · Read-only | Get one SharePoint list — its display name, template type, item count hints and whether it is hidden. |
graph_Free · Read-only | Get one row of a SharePoint list with all its column values. |
graph_Free · Read-only | Get the organisation's root SharePoint site — the tenant's default site collection, the one at the bare https://{tenant}.sharepoint.com address. |
graph_Free · Read-only | Get one SharePoint site by its id. |
graph_Free · Read-only | Resolve a SharePoint site from the address a person would paste from their browser, splitting it into its two halves. |
graph_Free · Read-only | List the columns a site content type contributes. |
graph_Free · Read-only | List the columns defined on one SharePoint list — their internal names, types, and whether each is required or read-only. |
graph_Free · Read-only | List the previous versions of one list item, each with who changed it and when. |
graph_Free · Read-only | List the rows in a SharePoint list, WITH their column values. |
graph_Free · Read-only | List the SITE columns — reusable column definitions available to every list in the site, as opposed to the per-list columns graph_list_list_columns returns. |
graph_Free · Read-only | List the content types defined on a SharePoint site. |
graph_Free · Read-only | List the lists in a SharePoint site. |
graph_Free · Read-only | List the SharePoint sites in the organisation. |
graph_Free · Read-only | List the subsites directly under one SharePoint site. |
graph_Free · Read-only | Find SharePoint sites by keyword — the fastest way to turn a site NAME a person used into the site id every other tool here needs. |
graph_Pro · Write | Rename a list or change its description. |
graph_Pro · Write | Change column values on one row. |
Teams
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Add somebody to a PRIVATE or SHARED channel, granting them its whole history and its own files. |
graph_Pro · Destructive | Add somebody to a team. |
graph_Pro · Destructive | Archive a channel, making it READ-ONLY for everyone: nobody can post, reply, react or change its settings until it is unarchived. |
graph_Pro · Destructive | Archive a team, making it READ-ONLY FOR EVERY MEMBER at once — nobody can post, reply or change anything until it is unarchived. |
graph_Pro · Write | Add a channel to a team. |
graph_Pro · Write | Create a new team. |
graph_Pro · Destructive | Delete a channel AND ITS ENTIRE CONVERSATION HISTORY. |
graph_Free · Read-only | Get one channel — its description, its membershipType (standard, private or shared) and its web URL. |
graph_Free · Read-only | Get the SharePoint folder holding a channel's files. |
graph_Free · Read-only | Get one channel post in full — its body, who wrote it, when, whether it has been edited or deleted, and any attachments or mentions. |
graph_Free · Read-only | Get one team with its settings — who may create channels, whether guests can be added, whether members can delete messages, and whether the team is archived. |
graph_Free · Read-only | Get one team membership. |
graph_Free · Read-only | List EVERY channel in a team including private and shared ones, each with its membershipType. |
graph_Free · Read-only | List the members of a PRIVATE or SHARED channel — the people who can see it beyond the team's own membership. |
graph_Free · Read-only | List the top-level posts in a channel, newest first. |
graph_Free · Read-only | List the tabs pinned across the top of a channel — the wikis, Planner boards, websites and documents a team has attached to it. |
graph_Free · Read-only | List a team's STANDARD channels — the ones every member sees. |
graph_Free · Read-only | List the teams the SIGNED-IN user belongs to. |
graph_Free · Read-only | List the replies to one channel post — the actual discussion, which the channel listing omits. |
graph_Free · Read-only | List the Teams apps installed in a team. |
graph_Free · Read-only | List a team's members. |
graph_Free · Read-only | List the teams in the organisation. |
graph_Pro · Destructive | Remove somebody from a private or shared channel. |
graph_Pro · Destructive | Remove somebody from a team. |
graph_Pro · Destructive | Reply to an existing channel post, in that post's thread. |
graph_Pro · Destructive | Post a message to a Teams channel. |
graph_Pro · Write | Restore an archived channel, giving its members back the ability to post and edit. |
graph_Pro · Write | Restore an archived team to normal use. |
graph_Pro · Write | Rename a channel or change its description. |
graph_Pro · Write | Change a team's name or description. |
graph_Pro · Destructive | Promote a team member to owner, or demote an owner back to a member. |
Chats & Presence
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Add somebody to a group chat. |
graph_Free · Read-only | Get one chat — its type (oneOnOne, group or meeting), its topic if it has one, and when it was last updated. |
graph_Free · Read-only | Get one chat message in full — its body, sender, timestamps, attachments and mentions. |
graph_Free · Read-only | Get the Teams availability of up to 650 people in ONE call. |
graph_Free · Read-only | Get one person's Teams availability — Available, Busy, DoNotDisturb, Away or Offline, plus the activity behind it (InACall, InAMeeting, Presenting). |
graph_Free · Read-only | List who is in a chat. |
graph_Free · Read-only | List the messages in one chat, newest first. |
graph_Free · Read-only | List the SIGNED-IN user's Teams chats — one-to-one, group and meeting conversations. |
graph_Free · Read-only | List the messages pinned to the top of a chat. |
graph_Pro · Write | Pin a message to the top of a chat so everyone in it sees it first. |
graph_Pro · Destructive | Send a message to an existing Teams chat. |
graph_Pro · Write | Remove a pin from a chat. |
Intune Applications
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Set which groups an app is deployed to. |
graph_Pro · Destructive | Grant an Intune role to one or more security groups. |
graph_Pro · Write | Author a custom Intune administrator role. |
graph_Pro · Destructive | Revoke an Intune role assignment. |
graph_Pro · Destructive | Delete a custom Intune role. |
graph_Free · Read-only | Get one Intune role with its full permission list. |
graph_Free · Read-only | Get one app protection or app configuration policy with all its settings. |
graph_Free · Read-only | Get one app registration — which person, which app, which device, which platform version, and when it last checked in. |
graph_Free · Read-only | Get one managed application in full. |
graph_Pro · Destructive | Get one Apple Volume Purchase Program token, INCLUDING ITS VALUE — the same credential disclosure as graph_list_vpp_tokens, for a single token. |
graph_Free · Read-only | List the policies ACTUALLY IN FORCE for one app registration — what is really protecting that person's app right now. |
graph_Free · Read-only | List the policies that SHOULD apply to one app registration — what has been targeted at it, as opposed to what has actually taken effect. |
graph_Free · Read-only | List who holds one Intune role, and over which scope. |
graph_Free · Read-only | List Intune's own administrator roles — the built-in ones (Help Desk Operator, Application Manager, Read Only Operator) and any custom roles. |
graph_Free · Read-only | List Intune's app protection and app configuration policies — the MAM rules that control copy-paste out of company apps, save-as to personal storage, and PIN requirements. |
graph_Free · Read-only | List the app-and-user pairings MAM knows about — each is one person using one managed app on one device, with the platform, app version and last sync time. |
graph_Free · Read-only | Get Intune's own summary reports on app protection — aggregate counts of users and apps by policy state. |
graph_Free · Read-only | List which groups an app is deployed to and how — required (installed automatically), available (offered in Company Portal) or uninstall (actively removed). |
graph_Free · Read-only | List the applications Intune manages — store apps, line-of-business packages and web links across every platform. |
graph_Pro · Destructive | List the Apple Volume Purchase Program tokens uploaded to Intune, INCLUDING EACH TOKEN'S VALUE. |
graph_Pro · Destructive | Set which apps an app protection policy covers. |
graph_Pro · Destructive | Change an existing Intune role assignment's members or scope. |
graph_Pro · Destructive | Change a custom Intune role's name, description or permissions. |
Partner Center (CSP)
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get one CSP customer's account record — company profile, primary domain, relationship to the partner and the tenant id everything else keys on. |
graph_Free · Read-only | Get the current billing period's rated usage for a customer's Azure subscriptions — spend so far, per subscription, before the invoice exists. |
graph_Free · Read-only | Get one invoice's header — billing period, totals by currency, due date and the document links. |
graph_Free · Read-only | Get one CSP order by id, with its line items, quantities, offer ids and current status. |
graph_Free · Read-only | Get one Microsoft service request in full — its status, severity, product area and the support engineer's notes. |
graph_Free · Read-only | Get one CSP subscription in full, including its offer, quantity, commitment term, auto-renew setting and — for an add-on — the parent subscription it hangs off. |
graph_Free · Read-only | Break one Azure subscription's current-period spend down by resource. |
graph_Free · Read-only | List the orders placed for a CSP customer — what was bought, when, at what quantity and on which billing cycle. |
graph_Free · Read-only | List the Microsoft support tickets raised on a customer's behalf, with their status and severity. |
graph_Free · Read-only | List everything a CSP customer is subscribed to — offer, quantity, billing cycle, term, status and renewal settings. |
graph_Free · Read-only | List the customers in this partner's CSP account — everyone the partner bills, with their company name, domain and tenant id. |
graph_Free · Read-only | List an invoice's line items for one billing provider — the per-customer, per-subscription detail that actually explains a bill. |
graph_Free · Read-only | List the partner's own invoices from Microsoft — invoice id, billing period, currency, total and payment status. |
graph_Free · Read-only | List the subscriptions one order produced. |
graph_Free · Read-only | Find CSP customers whose company name starts with a given string. |
Partner Center Commerce
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Change the license quantity of a customer's subscription. |
graph_Pro · Destructive | Check out a customer's cart: Partner Center places the orders and the customer is billed. |
graph_Pro · Write | Create a cart for a customer: the products to buy, their quantities, billing cycles and terms. |
graph_Free · Read-only | Get one of a customer's carts: its lines with their pricing, its status and when it expires (seven days after it was created). |
graph_Free · Read-only | List the SKUs of one catalog product in one country, from graph_list_partner_products. |
graph_Free · Read-only | List the products a CSP partner can sell in one country, for one catalog view (for example OnlineServices for Microsoft 365 and Copilot, Software, Azure, MarketplaceSaaS). |
graph_Free · Read-only | List the availabilities of one SKU in one country. |
graph_Pro · Write | Replace the lines of a customer's cart. |
Lighthouse Tenants
| Tool | What it does |
|---|---|
graph_Pro · Write | Attach a Lighthouse tag to one or more managed tenants. |
graph_Pro · Write | Create a tag you can attach to managed tenants in Microsoft 365 Lighthouse, to group customers for reporting and management. |
graph_Pro · Destructive | Delete a Lighthouse tenant tag. |
graph_Free · Read-only | Get one Lighthouse audit event record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one managed tenant record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one tenant customized information records (the contacts and website you keep per customer) record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one tenant detailed information records (verified domains, size, region, license counts) record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one tenant group record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one tenant tag record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | List Lighthouse audit events across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List the signed-in user's own role assignments in each managed tenant, as Lighthouse sees them. |
graph_Free · Read-only | List tenant customized information records (the contacts and website you keep per customer) across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List tenant detailed information records (verified domains, size, region, license counts) across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List tenant groups across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List tenant tags across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List per-service usage figures across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List managed tenants across the customers you manage in Microsoft 365 Lighthouse. |
graph_Pro · Destructive | Offboard a managed customer tenant from Microsoft 365 Lighthouse. |
graph_Pro · Destructive | Reset a managed customer tenant's onboarding status in Lighthouse so the onboarding can be run again. |
graph_Free · Read-only | Find the tenant groups a managed tenant belongs to. |
graph_Pro · Destructive | Detach a Lighthouse tag from one or more managed tenants. |
graph_Pro · Write | Change the website or contacts you keep for one managed customer in Lighthouse. |
graph_Pro · Write | Rename a Lighthouse tenant tag or change its description. |
Lighthouse Insights
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get one record of Cloud PC connection health results from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of Windows 365 Cloud PC devices from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of Windows 365 Cloud PC overview figures from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of device compliance policy setting state summaries from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of Conditional Access policy coverage (which users and apps each customer's policies cover) from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of MFA and self-service password reset registration summaries from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of managed device compliance records from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of managed device compliance trend points from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of malware states of Windows devices registered with Intune from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one record of protection states of Windows devices registered with Intune from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | List aggregated device compliance policy results across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List Cloud PC connection health results across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List Windows 365 Cloud PC devices across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List Windows 365 Cloud PC overview figures across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List device compliance policy setting state summaries across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List Conditional Access policy coverage (which users and apps each customer's policies cover) across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List MFA and self-service password reset registration summaries across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List managed device compliance trend points across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List managed device compliance records across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List malware states of Windows devices registered with Intune across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List protection states of Windows devices registered with Intune across the customers you manage in Microsoft 365 Lighthouse. |
Lighthouse Baselines
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Apply a baseline management action to a managed tenant or a tenant group. |
graph_Pro · Destructive | Change the deployment status of a management action in a managed tenant, for example to pause or resume a baseline rollout. |
graph_Free · Read-only | Get one baseline management action record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one tenant-level deployment statuses of management action record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one baseline management intent record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one baseline management template record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | List tenant-level deployment statuses of management actions across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List baseline management actions across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List baseline management intents across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List baseline management templates across the customers you manage in Microsoft 365 Lighthouse. |
Lighthouse Alerts
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get one managed tenant alerts (alerts Lighthouse raised for the customers you manage) record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one managed tenant alert logs (what happened to each alert) record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one managed tenant alert rules (the rules that raise those alerts) record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | Get one managed tenant alert rule definitions (the built-in rule catalog) record from Microsoft 365 Lighthouse by its id. |
graph_Free · Read-only | List managed tenant alert logs (what happened to each alert) across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List managed tenant alert rule definitions (the built-in rule catalog) across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List managed tenant alert rules (the rules that raise those alerts) across the customers you manage in Microsoft 365 Lighthouse. |
graph_Free · Read-only | List managed tenant alerts (alerts Lighthouse raised for the customers you manage) across the customers you manage in Microsoft 365 Lighthouse. |
Audit Log Search
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get one audit log search by id, with its status (notStarted, running, succeeded, failed or cancelled) and the filters it was started with. |
graph_Free · Read-only | List the audit records a finished search matched. |
graph_Free · Read-only | List the audit log searches that exist in the tenant, with their status. |
graph_Free · Read-only | Start a Microsoft Purview audit log search. |
Service Health and Message Center
| Tool | What it does |
|---|---|
graph_Pro · Write | For the signed-in user, archive Message center posts. |
graph_Free · Read-only | Download the content of one Message center attachment. |
graph_Free · Read-only | Download the post-incident report Microsoft publishes for a resolved service health issue. |
graph_Pro · Write | For the signed-in user, mark Message center posts as favorites. |
graph_Free · Read-only | Get the metadata of one Message center attachment. |
graph_Free · Read-only | Get one Message center post by id, with its body, category, severity, action-required date and attachments flag. |
graph_Free · Read-only | Get the health overview of one Microsoft 365 service by its name, optionally with its issues expanded. |
graph_Free · Read-only | Get one service health issue by id, with its impact description, status and update history. |
graph_Free · Read-only | List the attachments of one Message center post (metadata only: name, size, last modified). |
graph_Free · Read-only | List Message center posts: the announcements about upcoming Microsoft 365 changes, with category, severity and the date an action is due. |
graph_Free · Read-only | List service health issues (incidents and advisories) across Microsoft 365 services. |
graph_Free · Read-only | List the health of each Microsoft 365 service for the organization: one overview per service with its current status. |
graph_Pro · Write | For the signed-in user, mark Message center posts as read. |
graph_Pro · Write | For the signed-in user, mark Message center posts as unread. |
graph_Pro · Write | For the signed-in user, move archived Message center posts back to the inbox. |
graph_Pro · Write | For the signed-in user, remove the favorite mark from Message center posts. |
Windows 365 Cloud PCs
| Tool | What it does |
|---|---|
graph_Pro · Write | Create a restore snapshot of a Windows 365 Cloud PC in a storage account. |
graph_Pro · Destructive | End the grace period of a Windows 365 Cloud PC whose license was removed. |
graph_Free · Read-only | Get one Windows 365 Cloud PC by id: status, managed device, user, policy, service plan, grace-period end and last remote action. |
graph_Free · Read-only | Get the connectivity history of a Windows 365 Cloud PC: when it was reachable or not, and why. |
graph_Free · Read-only | Get the launch details of one user's Cloud PC: the Windows 365 URL that opens it and whether it can be started. |
graph_Free · Read-only | List the results of the remote actions run on a Windows 365 Cloud PC. |
graph_Free · Read-only | List the Windows 365 service plans (sizes) available to the organization, with vCPU, RAM and storage. |
graph_Free · Read-only | List the restore snapshots of a Windows 365 Cloud PC. |
graph_Free · Read-only | List the remote actions (reboot, rename, restore, resize and so on) a Windows 365 Cloud PC supports right now, with their state. |
graph_Free · Read-only | List the Windows 365 Cloud PCs in the directory with their status, user, provisioning policy and service plan. |
graph_Pro · Destructive | Power off a Windows 365 Cloud PC. |
graph_Pro · Write | Power on a Windows 365 Cloud PC. |
graph_Pro · Destructive | Reboot a Windows 365 Cloud PC. |
graph_Pro · Write | Change the display name of a Windows 365 Cloud PC. |
graph_Pro · Destructive | Reprovision a Windows 365 Cloud PC: rebuild it from its provisioning policy image. |
graph_Pro · Destructive | Change the service plan (size) of a Windows 365 Cloud PC. |
graph_Pro · Destructive | Restore a Windows 365 Cloud PC to an earlier snapshot. |
graph_Pro · Write | Start Microsoft's troubleshooting check on a Windows 365 Cloud PC that cannot be reached. |
Windows 365 Policies
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Assign a Windows 365 provisioning policy to groups. |
graph_Pro · Destructive | Assign a Windows 365 user setting to groups. |
graph_Pro · Write | Upload an Azure virtual machine image as a custom Windows 365 device image. |
graph_Pro · Write | Create a Windows 365 on-premises network connection. |
graph_Pro · Write | Create a Windows 365 provisioning policy. |
graph_Pro · Write | Create a Windows 365 user setting. |
graph_Pro · Destructive | Delete a custom Windows 365 device image. |
graph_Pro · Destructive | Delete a Windows 365 on-premises network connection. |
graph_Pro · Destructive | Delete a Windows 365 provisioning policy. |
graph_Pro · Destructive | Delete a Windows 365 user setting. |
graph_Free · Read-only | Get one custom Windows 365 device image, with its upload status. |
graph_Free · Read-only | Get one Windows 365 gallery image. |
graph_Free · Read-only | Get one Windows 365 on-premises network connection, including its health check status. |
graph_Free · Read-only | Get one Windows 365 provisioning policy, optionally with its assignments expanded. |
graph_Free · Read-only | Get one Windows 365 user setting, optionally with its assignments expanded. |
graph_Free · Read-only | List the custom device images uploaded for Windows 365. The signed-in user needs the Windows 365 Administrator role (or a role that includes it) in the directory. |
graph_Free · Read-only | List the Microsoft-provided Windows 365 gallery images a provisioning policy can use. |
graph_Free · Read-only | List the Windows 365 on-premises network connections: the Azure virtual network, subnet and domain join account Cloud PCs use. |
graph_Free · Read-only | List the Windows 365 provisioning policies: image, region and join type used to create Cloud PCs. |
graph_Free · Read-only | List the Azure virtual machine images in the tenant's subscriptions that can be uploaded as custom Windows 365 device images. |
graph_Free · Read-only | List the Windows 365 user settings: local admin, reset and restore point settings applied to groups of users. |
graph_Pro · Write | Start the health checks of a Windows 365 on-premises network connection (DNS, domain join, endpoint reachability). |
graph_Pro · Destructive | Change a Windows 365 on-premises network connection. |
graph_Pro · Destructive | Replace the Active Directory domain join account password stored on a Windows 365 on-premises network connection. |
graph_Pro · Destructive | Change a Windows 365 provisioning policy. |
graph_Pro · Destructive | Change a Windows 365 user setting. |
Windows 365 Reports
| Tool | What it does |
|---|---|
graph_Free · Read-only | Count the Windows 365 Cloud PCs by status. |
graph_Free · Read-only | Get a Windows 365 report on the status of remote actions run on Cloud PCs. |
graph_Free · Read-only | Get a Windows 365 report on the status of bulk actions on Cloud PCs. |
graph_Free · Read-only | Get one Windows 365 audit event. |
graph_Free · Read-only | Get one Windows 365 bulk action with the per-Cloud PC status. |
graph_Free · Read-only | Get the tenant-wide Windows 365 settings: automatic Intune enrollment, single sign-on and the default OS and user account type. |
graph_Free · Read-only | Get the Windows 365 recommendation report: which Cloud PCs Microsoft suggests resizing based on usage. |
graph_Free · Read-only | Get a Windows 365 report export job by id: its status and, once complete, the download URL. |
graph_Free · Read-only | Get the Windows 365 tenant encryption setting (platform-managed or customer-managed keys). |
graph_Free · Read-only | Get a Windows 365 report on the connection quality (round-trip time, bandwidth) of Cloud PC sessions. |
graph_Free · Read-only | Get a Windows 365 report on remote connections to Cloud PCs aggregated by day. |
graph_Free · Read-only | Get a Windows 365 report on the Cloud PCs users cannot reach. |
graph_Free · Read-only | Get a Windows 365 report on the history of remote connections to Cloud PCs. |
graph_Free · Read-only | Get a Windows 365 report on shared-use Windows 365 license usage. |
graph_Free · Read-only | Get a Windows 365 report on tenant-level Windows 365 metrics. |
graph_Free · Read-only | Get a Windows 365 report on remote connections to Cloud PCs aggregated in total. |
graph_Free · Read-only | Get a Windows 365 report on the results of Cloud PC troubleshooting runs. |
graph_Free · Read-only | List the activity type names that can appear in Windows 365 audit events, to filter graph_list_cloud_pc_audit_events. |
graph_Free · Read-only | List the Windows 365 audit events: who changed what in Windows 365 and when. |
graph_Free · Read-only | List the bulk actions run on Windows 365 Cloud PCs. |
graph_Free · Read-only | List the regions where Windows 365 can provision Cloud PCs, with their availability. |
graph_Free · Read-only | Start an export job for a Windows 365 report. |
graph_Pro · Destructive | Change the tenant-wide Windows 365 settings. |
eDiscovery Cases
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Add a user or a role group to an eDiscovery case. |
graph_Pro · Destructive | Close an eDiscovery case. |
graph_Pro · Destructive | Create an eDiscovery case. |
graph_Pro · Destructive | Delete an eDiscovery case. |
graph_Free · Read-only | Get one eDiscovery case: name, status, description, dates and the people who created and last changed it. |
graph_Free · Read-only | Get one eDiscovery case operation: its action, status (notStarted, running, succeeded, partiallySucceeded, failed), result and times. |
graph_Free · Read-only | Get the settings of an eDiscovery case: case type, OCR, redundancy detection, topic modeling and review set grouping. |
graph_Free · Read-only | List the members of an eDiscovery case (users and role groups). |
graph_Free · Read-only | List the operations of an eDiscovery case (indexing, estimates, exports, purges, review set loads, hold updates) with their status. |
graph_Free · Read-only | List the Microsoft Purview eDiscovery cases the signed-in user can see, with status, description and dates. |
graph_Pro · Destructive | Remove a member from an eDiscovery case. |
graph_Pro · Destructive | Reopen an eDiscovery case that was closed. |
graph_Pro · Destructive | Reset an eDiscovery case's settings to Microsoft's defaults. |
graph_Pro · Destructive | Change an eDiscovery case's name, description or external id. |
graph_Pro · Destructive | Change the settings of an eDiscovery case. |
eDiscovery Custodians and Data Sources
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Reactivate a released custodian in a case. |
graph_Pro · Destructive | Start applying the case's legal hold to custodians. |
graph_Pro · Destructive | Start applying the case's legal hold to non-custodial data sources. |
graph_Pro · Destructive | Add a person to an eDiscovery case as a custodian, by their primary email address. |
graph_Pro · Destructive | Add a Microsoft 365 group (its mailbox, its site or both) to a custodian by the group's email address. |
graph_Pro · Destructive | Add a SharePoint site to a custodian. |
graph_Pro · Destructive | Add a mailbox or OneDrive source to a custodian. |
graph_Pro · Destructive | Add a mailbox or a site to a case without a custodian. |
graph_Pro · Destructive | Remove a site source from a custodian. |
graph_Pro · Destructive | Remove a user source from a custodian. |
graph_Free · Read-only | Get one custodian: email, status, hold status, acknowledgment and dates. |
graph_Free · Read-only | Get the last index operation of a custodian: status and times. |
graph_Free · Read-only | Get one non-custodial data source: its source, status and hold status. |
graph_Free · Read-only | Get the last index operation of a non-custodial data source: status and times. |
graph_Free · Read-only | List the Microsoft 365 group sources of a custodian. |
graph_Free · Read-only | List the SharePoint site sources of a custodian. |
graph_Free · Read-only | List the mailbox and OneDrive sources of a custodian. |
graph_Free · Read-only | List the custodians of an eDiscovery case with their status and hold status. |
graph_Free · Read-only | List the non-custodial data sources of a case (mailboxes and sites that are not tied to a custodian). |
graph_Pro · Destructive | Release a custodian from a case. |
graph_Pro · Destructive | Release a non-custodial data source from a case. |
graph_Pro · Destructive | Start removing the case's legal hold from custodians. |
graph_Pro · Destructive | Start removing the case's legal hold from non-custodial data sources. |
graph_Pro · Destructive | Start an index operation that makes a custodian and its sources searchable. |
graph_Pro · Destructive | Start an index operation that makes a non-custodial data source searchable. |
eDiscovery Searches
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Add one mailbox or one site to a search without making it a custodian source. |
graph_Pro · Destructive | Add a custodian source (a user, site or group source of a case custodian) to a search. |
graph_Pro · Destructive | Add a non-custodial data source to a search. |
graph_Pro · Destructive | Create a search in an eDiscovery case. |
graph_Pro · Destructive | Delete an eDiscovery search. |
graph_Pro · Destructive | Run an estimate of an eDiscovery search: how many items and how much data it finds, and in which locations. |
graph_Pro · Destructive | Export the item report of an estimated eDiscovery search (the list of items, without the items). |
graph_Pro · Destructive | Export the results of an estimated eDiscovery search to a PST or MSG package in Purview. |
graph_Free · Read-only | Get one search: name, KQL query, data source scopes and dates. |
graph_Free · Read-only | Get the last estimate of a search: status, item and size counts, and the unindexed counts. |
graph_Free · Read-only | List the additional sources (single mailboxes or sites) added to a search. |
graph_Free · Read-only | List the custodian sources a search runs over. |
graph_Free · Read-only | List the non-custodial data sources a search runs over. |
graph_Free · Read-only | List the searches of an eDiscovery case with their KQL query and scope. |
graph_Pro · Destructive | Delete the content that an eDiscovery search found. |
graph_Pro · Destructive | Remove a custodian source from a search. |
graph_Pro · Destructive | Remove a non-custodial data source from a search. |
graph_Pro · Destructive | Change an eDiscovery search's name, description, KQL query or data source scopes. |
eDiscovery Review Sets, Tags and Holds
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Add the results of an eDiscovery search to a review set (a collection from Microsoft 365 into the case's working copy). |
graph_Pro · Destructive | Add tags to, or remove tags from, every file a review set query finds. |
graph_Pro · Destructive | Create a legal hold policy in an eDiscovery case. |
graph_Pro · Destructive | Put a SharePoint site under a legal hold. |
graph_Pro · Destructive | Put a user's mailbox, OneDrive or both under a legal hold. |
graph_Pro · Destructive | Create a review set in an eDiscovery case. |
graph_Pro · Destructive | Save a KQL query on a review set. |
graph_Pro · Destructive | Create a review tag. |
graph_Pro · Destructive | Delete a legal hold policy. |
graph_Pro · Destructive | Take a SharePoint site off a legal hold. |
graph_Pro · Destructive | Take a user's mailbox or OneDrive off a legal hold. |
graph_Pro · Destructive | Delete a saved review set query. |
graph_Pro · Destructive | Remove a review tag. |
graph_Pro · Destructive | Disable a legal hold policy, which releases the hold across all its data sources in one operation. |
graph_Pro · Destructive | Enable a legal hold policy so the hold applies to all its data sources in one operation. |
graph_Pro · Destructive | Export the files of a review set from Purview. |
graph_Pro · Destructive | Export the files a review set query finds. |
graph_Free · Read-only | Get one legal hold policy: name, KQL content query, status and errors. |
graph_Free · Read-only | Get one review set: name, description and dates. |
graph_Free · Read-only | Get one file of an eDiscovery review set with its metadata. |
graph_Free · Read-only | Get one saved review set query: name and KQL. |
graph_Free · Read-only | Get one review tag: name, description and child selectability. |
graph_Free · Read-only | Get the review tags of a case as a parent and child tree. |
graph_Free · Read-only | List the SharePoint sites a legal hold covers. |
graph_Free · Read-only | List the mailboxes and OneDrives a legal hold covers. |
graph_Free · Read-only | List the legal hold policies of an eDiscovery case with their status and query. |
graph_Free · Read-only | List the files in an eDiscovery review set: name, size, dates, sender and recipients, tags and the extracted text status. |
graph_Free · Read-only | List the saved queries of a review set. |
graph_Free · Read-only | List the review sets of an eDiscovery case. |
graph_Free · Read-only | List the review tags of an eDiscovery case. |
graph_Pro · Destructive | Ask Purview to retry a legal hold policy that failed to deploy. |
graph_Free · Read-only | Run a saved review set query and return the files it finds. |
graph_Pro · Destructive | Change a legal hold's description or KQL query. |
graph_Pro · Destructive | Change a review set's name or description. |
graph_Pro · Destructive | Change a saved review set query. |
graph_Pro · Destructive | Change a review tag. |
Copilot Settings
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get the Copilot limited mode setting for Teams meetings: whether it is on and the group it applies to. |
graph_Free · Read-only | Get one Copilot setting from the tenant-level policy (Cloud Policy Service or Intune): its value as a string and the policy that holds it. |
graph_Pro · Destructive | Turn Copilot limited mode in Teams meetings on or off for one group. |
graph_Pro · Destructive | Change one Copilot setting in the tenant-level policy. |
Copilot Cost Management
| Tool | What it does |
|---|---|
graph_Pro · Write | Add a user as a recipient of a Copilot spending policy's alerts. |
graph_Pro · Destructive | Add a group to a selected-groups Copilot spending policy. |
graph_Pro · Destructive | Add a governed service to a Copilot spending policy, enabled or disabled. |
graph_Pro · Destructive | Create a Copilot spending policy that caps credit consumption for all users or for selected groups. |
graph_Pro · Destructive | Approve or reject one pending Copilot credit request. |
graph_Pro · Destructive | Approve or reject up to 100 Copilot credit requests in one call. |
graph_Pro · Destructive | Delete the alert configuration of a Copilot spending policy, which turns its alerts off. |
graph_Pro · Destructive | Delete a Copilot spending policy. |
graph_Free · Read-only | Get one Copilot credit request with its strong ETag. |
graph_Free · Read-only | Get one group's Copilot credit consumption for one completed UTC day. |
graph_Free · Read-only | Get one service's Copilot credit consumption for one completed UTC day. |
graph_Free · Read-only | Get the notify-only alert configuration of a Copilot spending policy: whether alerts are on and their thresholds. |
graph_Free · Read-only | Get one Copilot spending policy: its limits, billing methods, status and ETag. |
graph_Free · Read-only | Get one service setting of a Copilot spending policy, with the policy's ETag (parentEtag). |
graph_Free · Read-only | Get the tenant-wide Copilot credit balance snapshot, one row per billing method. |
graph_Free · Read-only | Get one user's Copilot credit consumption balance and the spending policy that governs them. |
graph_Free · Read-only | Get one user's Copilot balance row for one governed service. |
graph_Free · Read-only | Get one user's raw, billable-flagged Copilot usage over a window of at most 24 hours inside one UTC month. |
graph_Free · Read-only | Get one user's Copilot credit consumption for one completed UTC day. |
graph_Free · Read-only | List users' requests for Copilot credits, newest first, each with its strong ETag (@odata.etag) for a decision. |
graph_Free · Read-only | List a calendar month's Copilot credit consumption by funding class (prepaid, pay-as-you-go, unbilled overage and non-billable). |
graph_Free · Read-only | List Copilot credit consumption per security group for one completed UTC day. |
graph_Free · Read-only | List Copilot credit consumption per governed service for one completed UTC day. |
graph_Free · Read-only | List the users who receive a Copilot spending policy's alerts. |
graph_Free · Read-only | List the Copilot spending policies that cap credit consumption. |
graph_Free · Read-only | List the groups a selected-groups Copilot spending policy covers. |
graph_Free · Read-only | List the per-service settings of a Copilot spending policy: each governed service, its state and the policy's ETag (parentEtag). |
graph_Free · Read-only | List one user's per-service Copilot balance rows: why the user can or cannot use each governed service. |
graph_Free · Read-only | List Copilot credit consumption per user for one completed UTC day. |
graph_Free · Read-only | List one user's raw Copilot consumption by governed service over a window of at most 24 hours inside one UTC month. |
graph_Free · Read-only | List one user's raw Copilot usage grouped by session over a window of at most 24 hours inside one UTC month (20 sessions a page by default, 100 at most). |
graph_Pro · Destructive | Remove a user from a Copilot spending policy's alert recipients. |
graph_Pro · Destructive | Remove a group from a selected-groups Copilot spending policy. |
graph_Pro · Write | Create or change the notify-only alert configuration of a Copilot spending policy (alerts email the recipients; they never stop spending). |
graph_Pro · Destructive | Change a Copilot spending policy's name, limits or billing methods. |
graph_Pro · Destructive | Enable or disable one governed service on a Copilot spending policy (Microsoft has no delete: disabled is how a service is removed). |
Copilot Packages
| Tool | What it does |
|---|---|
graph_Pro · Destructive | Block a Copilot package for the whole organization. |
graph_Free · Read-only | Get one Copilot catalog package with its details: availability, deployment, owner and elements. |
graph_Free · Read-only | List the agents and apps in the organization's Copilot catalog, or the ones users requested. |
graph_Pro · Destructive | Make another user the owner of a Copilot package, for example when its owner leaves. |
graph_Pro · Write | Unblock a Copilot package so the organization can use it again. |
graph_Pro · Destructive | Change who may use a Copilot package (availableTo with its allowed users and groups) and who gets it deployed (deployedTo with its users and groups). |
Copilot Usage Reports
| Tool | What it does |
|---|---|
graph_Free · Read-only | Get the Microsoft 365 Copilot usage report on each user's last activity date per Microsoft 365 Copilot app, as JSON. |
graph_Free · Read-only | Get the Microsoft 365 Copilot usage report on the count of enabled and active Microsoft 365 Copilot users per app, as JSON. |
graph_Free · Read-only | Get the Microsoft 365 Copilot usage report on the daily trend of enabled and active Microsoft 365 Copilot users per app, as JSON. |
Entra Single Sign-On
| Tool | What it does |
|---|---|
graph_Pro · Write | Create a self-signed SAML token signing certificate on an enterprise application. |
graph_Free · Read-only | Get one Microsoft Entra application gallery template: its supported single sign-on and provisioning modes. |
graph_Pro · Write | Add an application from the Entra gallery to the directory: Microsoft creates the application and its service principal and answers both. |
graph_Free · Read-only | List the Microsoft Entra application gallery templates (the pre-integrated SaaS apps), for example filtered with displayName eq 'Slack' or categories/any(c:c eq 'security'). |
graph_Pro · Destructive | Set the SAML identifier URIs, the reply (redirect) URLs and the sign-out URL of an application. |
graph_Pro · Write | Set an enterprise application's single sign-on mode and its SAML settings: the preferred mode, the SAML relay state, the sign-in URL and the token signing certificate to use. |
Entra Provisioning
| Tool | What it does |
|---|---|
graph_Pro · Write | Create a provisioning (synchronization) job on an enterprise application from one of its templates. |
graph_Free · Read-only | Get one provisioning (synchronization) job: its status, last run, quarantine and schedule. |
graph_Free · Read-only | List the provisioning (synchronization) jobs of an enterprise application with their status and schedule. |
graph_Free · Read-only | List the provisioning (synchronization) templates of an enterprise application: the template ids a provisioning job is created from. |
graph_Pro · Destructive | Save the credentials an enterprise application provisions with: the BaseAddress (for a SCIM application, the vendor's SCIM endpoint URL) and the SecretToken. |
graph_Pro · Write | Start a provisioning (synchronization) job, or resume a paused one. |
Raw Requests
| Tool | What it does |
|---|---|
graph_Free · Read-only | Send one GET to any Microsoft Graph path, on v1.0 or beta, and return the response exactly as Graph sent it. |
graph_Pro · Destructive | Send one POST, PUT, PATCH or DELETE to any Microsoft Graph path, on v1.0 or beta, and return the response exactly as Graph sent it. |
Was this helpful?
More in Connector guides
Connect 3CXConnect AbleSignConnect Acronis Cyber Protect CloudConnect Action1Still need help? Ask the team