Skip to main content
Connector guides

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

  1. Open Connectors, then Set up Microsoft.
  2. Tick Microsoft Graph and any other Microsoft connector you want. One app serves all of them.
  3. Pick StackJack's app, or one app of your own. The wizard creates it for you, or fixes one you bring.
  4. Sign in on each connector, then consent your customers in one run.
  5. 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 seeWhat to do
A 403 when you preview Authorize all customersThat 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 AADSTS650052The 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 workedYour 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 dataThat 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

ToolWhat it does
graph_assign_user_license
Pro · Write
Assign one or more Microsoft 365 licences to a user.
graph_create_user
Pro · Write
Create a new user account.
graph_delete_user
Pro · Destructive
Delete a user account.
graph_get_signed_in_user
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_get_user
Free · Read-only
Get one user account in full, by object id or user principal name (their sign-in address).
graph_get_user_manager
Free · Read-only
Get the person recorded as a user's manager.
graph_list_deleted_users
Free · Read-only
List user accounts that have been deleted but are still recoverable.
graph_list_inactive_users
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_list_user_app_role_assignments
Free · Read-only
List the enterprise applications a user has been assigned to, and the role they hold in each.
graph_list_user_devices
Free · Read-only
List the devices registered to a user in the directory — the machines and phones their identity is attached to.
graph_list_user_direct_reports
Free · Read-only
List the people who report to a user.
graph_list_user_groups
Free · Read-only
List the groups, directory roles and administrative units a user belongs to DIRECTLY.
graph_list_user_licenses
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_list_user_owned_objects
Free · Read-only
List the directory objects a user owns — groups, application registrations and service principals.
graph_list_user_transitive_groups
Free · Read-only
List every group a user belongs to INCLUDING the ones reached through nested groups — their effective membership.
graph_list_users
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_permanently_delete_user
Pro · Destructive
Permanently remove a deleted user from the directory's recycle bin, ending the 30-day recovery window immediately.
graph_remove_user_license
Pro · Destructive
Remove one or more Microsoft 365 licences from a user.
graph_remove_user_manager
Pro · Destructive
Clear the manager relationship on a user, leaving them with none.
graph_reset_user_password
Pro · Destructive
Set a new password on a user account.
graph_restore_deleted_user
Pro · Write
Restore a user account from the directory's recycle bin, within the 30-day window.
graph_revoke_user_sign_in_sessions
Pro · Destructive
Invalidate every refresh token and session cookie a user holds, forcing them to sign in again everywhere — browsers, Outlook, Teams, phones.
graph_set_user_account_enabled
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_set_user_manager
Pro · Write
Set or replace the person recorded as a user's manager.
graph_update_user
Pro · Write
Update a user's profile details — display name, job title, department, office, phone numbers, usage location.

Groups

ToolWhat it does
graph_add_group_member
Pro · Write
Add a user, device, service principal or another group to a group.
graph_add_group_owner
Pro · Write
Add an owner to a group.
graph_create_group
Pro · Write
Create a security group or a Microsoft 365 group.
graph_delete_group
Pro · Destructive
Delete a group.
graph_get_group
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_list_deleted_groups
Free · Read-only
List groups that have been deleted but are still recoverable.
graph_list_group_app_role_assignments
Free · Read-only
List the enterprise applications a group is assigned to, and the role it holds in each.
graph_list_group_members
Free · Read-only
List the DIRECT members of a group — the users, other groups, devices and service principals added to it explicitly.
graph_list_group_memberships
Free · Read-only
List the groups and directory roles that a GROUP is itself a member of — the upward view of nesting.
graph_list_group_owners
Free · Read-only
List the owners of a group — the people who can manage its membership and settings without being directory administrators.
graph_list_group_transitive_members
Free · Read-only
List everyone who is effectively a member of a group, flattening every level of nesting.
graph_list_groups
Free · Read-only
List the groups in an Entra ID directory — security groups, Microsoft 365 groups and distribution lists.
graph_permanently_delete_group
Pro · Destructive
Permanently remove a deleted group from the recycle bin, ending the 30-day recovery window immediately.
graph_remove_group_member
Pro · Destructive
Remove a member from a group.
graph_remove_group_owner
Pro · Destructive
Remove an owner from a group.
graph_renew_group
Pro · Write
Renew a Microsoft 365 group, restarting its expiration clock.
graph_restore_deleted_group
Pro · Write
Restore a group from the directory's recycle bin, within the 30-day window.
graph_update_group
Pro · Write
Update a group's name, description or visibility.
graph_update_group_dynamic_membership_rule
Pro · Destructive
Change the rule that decides who belongs to a dynamic group.

Delegated Admin (GDAP)

ToolWhat it does
graph_approve_delegated_admin_relationship
Pro · Write
Approve a GDAP relationship that an indirect provider created for you as an indirect reseller.
graph_create_delegated_admin_access_assignment
Pro · Destructive
Grant one of the partner's security groups a set of administrative roles inside a customer's tenant.
graph_create_delegated_admin_relationship
Pro · Write
Create a GDAP relationship request for a customer.
graph_delete_delegated_admin_access_assignment
Pro · Destructive
Remove an access assignment, revoking that partner group's administrative roles in the customer's tenant.
graph_delete_delegated_admin_relationship
Pro · Destructive
Delete a GDAP relationship outright.
graph_get_delegated_admin_access_assignment
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_get_delegated_admin_customer
Free · Read-only
Get one delegated-admin customer by id, with its display name and tenant id.
graph_get_delegated_admin_relationship
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_get_delegated_admin_relationship_operation
Free · Read-only
Get one long-running GDAP operation by id and see whether it succeeded, is still running, or failed and why.
graph_get_delegated_admin_relationship_request
Free · Read-only
Get one GDAP relationship request by id, with the action it carried and its outcome.
graph_list_delegated_admin_access_assignments
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_list_delegated_admin_customer_service_management_details
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_list_delegated_admin_customers
Free · Read-only
List the customers this partner can administer, as the delegated-admin surface sees them.
graph_list_delegated_admin_relationship_operations
Free · Read-only
List the long-running operations on one GDAP relationship.
graph_list_delegated_admin_relationship_requests
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_list_delegated_admin_relationships
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_lock_delegated_admin_relationship_for_approval
Pro · Write
Finalize a draft GDAP relationship and lock it for the customer's approval, moving it from "created" to "approvalPending".
graph_reject_delegated_admin_relationship
Pro · Destructive
Reject a pending GDAP relationship that an indirect provider created for you as an indirect reseller.
graph_terminate_delegated_admin_relationship
Pro · Destructive
End an active GDAP relationship.
graph_update_delegated_admin_access_assignment
Pro · Destructive
Replace the set of customer roles an existing access assignment grants.
graph_update_delegated_admin_relationship
Pro · Write
Update a GDAP relationship's name, duration, requested roles or auto-extension.

Licensing

ToolWhat it does
graph_assign_group_license
Pro · Write
Assign licence SKUs to a group, so every member receives them automatically.
graph_get_group_license_assignment
Free · Read-only
Get the licences assigned to a group and the current state of applying them to its members.
graph_get_subscribed_sku
Free · Read-only
Get one purchased SKU in full, including every service plan it contains and each plan's provisioning status.
graph_get_user_license_assignment_states
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_list_subscribed_skus
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_list_users_with_license
Free · Read-only
List everyone assigned a particular licence SKU.
graph_remove_group_license
Pro · Destructive
Remove licence SKUs from a group, which unlicenses every member who was relying on that group for them.
graph_reprocess_user_license_assignment
Pro · Write
Re-evaluate a user's group-based licence assignments.

Organization & Domains

ToolWhat it does
graph_create_domain
Pro · Write
Add a DNS domain to the tenant.
graph_delete_domain
Pro · Destructive
Remove a domain from the tenant.
graph_force_delete_domain
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_get_domain
Free · Read-only
Get one domain in full.
graph_get_domain_root_domain
Free · Read-only
Get the root domain a subdomain hangs off.
graph_get_organization
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_get_organization_branding
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_list_certificate_based_auth_configurations
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_list_domain_name_references
Free · Read-only
List the users, groups and applications whose identity references a domain.
graph_list_domain_service_configuration_records
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_list_domain_verification_dns_records
Free · Read-only
Get the DNS records that must be published in a domain's zone file BEFORE ownership can be verified.
graph_list_domains
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_list_group_setting_templates
Free · Read-only
List the setting templates Entra publishes, each naming the settings it contains, their types and their default values.
graph_list_group_settings
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_list_organization_branding_localizations
Free · Read-only
List the per-language overrides of the tenant's sign-in branding.
graph_promote_domain
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_update_domain
Pro · Write
Update a verified domain's supported services, password policy or default status.
graph_update_group_setting
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_update_organization
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_verify_domain
Pro · Write
Prove ownership of a domain by having Entra look for the verification record in its public DNS.

Applications & Service Principals

ToolWhat it does
graph_add_application_key
Pro · Destructive
Add a certificate credential to an app registration, for rolling an expiring certificate without downtime.
graph_add_application_owner
Pro · Write
Add a user as an owner of an app registration.
graph_add_application_password
Pro · Destructive
Generate a new client secret for an app registration and return its value.
graph_add_service_principal_key
Pro · Destructive
Add a certificate credential to a service principal, for rolling an expiring certificate.
graph_add_service_principal_owner
Pro · Write
Add a user as an owner of a service principal.
graph_add_service_principal_password
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_create_application
Pro · Write
Register a new application in this directory.
graph_create_delegated_grant
Pro · Destructive
Consent to delegated permissions for a client application, on behalf of one user or of everyone in the tenant.
graph_create_service_principal
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_delete_application
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_delete_delegated_grant
Pro · Destructive
Revoke a delegated permission grant entirely.
graph_delete_service_principal
Pro · Destructive
Delete an application's identity in this tenant, taking its consent grants and role assignments with it.
graph_get_application
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_get_service_principal
Free · Read-only
Get one service principal in full — an application's identity inside this specific tenant.
graph_grant_app_role_assignment
Pro · Destructive
Assign an app role on a resource application to a user, group or service principal.
graph_list_application_owners
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_list_applications
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_list_delegated_grants
Free · Read-only
List every delegated permission grant in the directory — the tenant-wide consent inventory.
graph_list_deleted_applications
Free · Read-only
List app registrations in the 30-day recycle bin.
graph_list_service_principal_app_role_assigned_to
Free · Read-only
List the app-role assignments made ON this service principal — who has been given a role in this application.
graph_list_service_principal_app_role_assignments
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_list_service_principal_delegated_grants
Free · Read-only
List the delegated permission grants for one client application — what it may do on behalf of a signed-in user.
graph_list_service_principal_owners
Free · Read-only
List the owners of a service principal.
graph_list_service_principals
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_permanently_delete_application
Pro · Destructive
Permanently remove a deleted app registration from the recycle bin.
graph_remove_application_key
Pro · Destructive
Remove a certificate credential from an app registration.
graph_remove_application_owner
Pro · Destructive
Remove an owner from an app registration.
graph_remove_application_password
Pro · Destructive
Delete a client secret from an app registration by its keyId.
graph_remove_service_principal_key
Pro · Destructive
Remove a certificate credential from a service principal.
graph_remove_service_principal_owner
Pro · Destructive
Remove an owner from a service principal.
graph_remove_service_principal_password
Pro · Destructive
Delete a client secret from a service principal by its keyId.
graph_restore_deleted_application
Pro · Write
Restore an app registration from the 30-day recycle bin.
graph_revoke_app_role_assignment
Pro · Destructive
Remove an app-role assignment, revoking that access.
graph_set_service_principal_enabled
Pro · Destructive
Turn an application's sign-in on or off in this tenant.
graph_update_application
Pro · Write
Update an app registration's properties.
graph_update_delegated_grant
Pro · Destructive
Replace the scopes on an existing delegated permission grant.
graph_update_service_principal
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

ToolWhat it does
graph_activate_directory_role
Pro · Write
Activate a directory role in this tenant from its template, creating the role object so members can be added to it.
graph_activate_eligible_role
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_add_directory_role_member
Pro · Destructive
Add a user, group or service principal to a directory role, granting that role's administrative permissions permanently and immediately.
graph_assign_role_with_schedule
Pro · Destructive
Assign a directory role through Privileged Identity Management with a time limit — an ACTIVE grant that expires on its own.
graph_create_role_assignment
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_create_role_definition
Pro · Write
Create a custom directory role from a set of resource actions.
graph_deactivate_eligible_role
Pro · Write
Give up a role the signed-in user activated, before it expires on its own.
graph_delete_role_assignment
Pro · Destructive
Remove a unified RBAC role assignment, revoking those permissions immediately.
graph_delete_role_definition
Pro · Destructive
Delete a custom role definition.
graph_get_directory_role
Free · Read-only
Get one activated directory role by its object id, including the roleTemplateId that identifies WHICH Entra role it is.
graph_get_role_definition
Free · Read-only
Get one role definition with its full permission set.
graph_get_role_management_policy
Free · Read-only
Get one PIM policy, expanding its rules — which is where the settings that matter actually live.
graph_list_directory_role_members
Free · Read-only
List who holds a directory role.
graph_list_directory_role_templates
Free · Read-only
List every directory role Entra defines, whether or not this tenant has ever used one.
graph_list_directory_roles
Free · Read-only
List the directory roles that are ACTIVE in this tenant.
graph_list_role_assignment_instances
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_list_role_assignment_requests
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_list_role_assignment_schedules
Free · Read-only
List the scheduled role ASSIGNMENTS — active grants managed through Privileged Identity Management, including the ones with an expiry date.
graph_list_role_assignments
Free · Read-only
List unified RBAC role assignments — the permanent grants, including the SCOPED ones that the directory-role member listing cannot express.
graph_list_role_definitions
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_list_role_eligibility_instances
Free · Read-only
List the role eligibilities that are in effect right NOW, as opposed to the schedules that define them.
graph_list_role_eligibility_requests
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_list_role_eligibility_schedules
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_list_role_management_policies
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_list_role_management_policy_assignments
Free · Read-only
List which PIM policy applies to which role.
graph_make_principal_eligible_for_role
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_remove_directory_role_member
Pro · Destructive
Remove a member from a directory role, revoking those administrative permissions immediately.
graph_remove_role_eligibility
Pro · Destructive
Remove someone's eligibility for a directory role, so they can no longer elevate into it.
graph_remove_scheduled_role_assignment
Pro · Destructive
Remove a role assignment that was made through Privileged Identity Management, revoking it immediately rather than waiting for it to expire.
graph_update_role_definition
Pro · Destructive
Update a custom role definition.

Authentication Methods

ToolWhat it does
graph_add_user_email_method
Pro · Destructive
Register an email address on an account for self-service password reset.
graph_add_user_phone_method
Pro · Destructive
Register a phone number for multifactor authentication on an account.
graph_create_temporary_access_pass
Pro · Destructive
Issue a Temporary Access Pass for a user and RETURN THE PASSCODE.
graph_delete_temporary_access_pass
Pro · Destructive
Revoke a Temporary Access Pass immediately, before it expires on its own.
graph_delete_user_authenticator_method
Pro · Destructive
Remove a Microsoft Authenticator registration from an account — the standard lost-phone and replaced-phone action.
graph_delete_user_email_method
Pro · Destructive
Remove an email address from an account's password-reset methods.
graph_delete_user_fido2_method
Pro · Destructive
Remove a FIDO2 security key from an account.
graph_delete_user_phone_method
Pro · Destructive
Remove a phone number from an account's authentication methods.
graph_delete_user_software_oath_method
Pro · Destructive
Remove a third-party authenticator (software OATH) token from an account.
graph_delete_user_windows_hello_method
Pro · Destructive
Remove a Windows Hello for Business registration from an account.
graph_disable_user_sms_sign_in
Pro · Destructive
Stop a user signing in with an SMS code, leaving the number registered as a second factor.
graph_enable_user_sms_sign_in
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_get_authentication_methods_policy
Free · Read-only
Get the tenant's authentication methods policy — which methods are permitted, and for whom.
graph_list_authentication_method_registrations
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_list_user_authentication_methods
Free · Read-only
List every authentication method registered on one account, of every type, in a single call.
graph_list_user_authenticator_methods
Free · Read-only
List the Microsoft Authenticator registrations on an account, including the device each one is installed on.
graph_list_user_email_methods
Free · Read-only
List the email addresses registered on an account for self-service password reset.
graph_list_user_fido2_methods
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_list_user_phone_methods
Free · Read-only
List the phone numbers registered for multifactor authentication on one account, each with its type — mobile, alternateMobile or office.
graph_list_user_software_oath_methods
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_list_user_temporary_access_passes
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_list_user_windows_hello_methods
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_reset_user_password_generated
Pro · Destructive
Ask Entra to generate a new password for a user and RETURN IT.
graph_set_authentication_method_configuration
Pro · Destructive
Turn an authentication method on or off for the whole tenant, or restrict it to particular groups.
graph_update_authentication_methods_policy
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_update_user_phone_method
Pro · Destructive
Change the number on an existing phone authentication method — the ordinary fix when somebody changes handset or carrier.

Conditional Access

ToolWhat it does
graph_create_authentication_context
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_create_authentication_strength_policy
Pro · Write
Define a custom authentication strength — a named set of method combinations that a Conditional Access policy can require.
graph_create_conditional_access_policy
Pro · Destructive
Create a Conditional Access policy.
graph_create_country_named_location
Pro · Write
Define a named location from a list of countries, for policies to refer to by name.
graph_create_ip_named_location
Pro · Write
Define a named location from IP ranges, for policies to refer to by name.
graph_delete_authentication_context
Pro · Destructive
Delete an authentication context.
graph_delete_authentication_strength_policy
Pro · Destructive
Delete a custom authentication strength policy.
graph_delete_conditional_access_policy
Pro · Destructive
Delete a Conditional Access policy permanently.
graph_delete_named_location
Pro · Destructive
Delete a named location.
graph_get_authentication_strength_policy
Free · Read-only
Get one authentication strength policy with its allowedCombinations — the exact method combinations that satisfy it.
graph_get_conditional_access_policy
Free · Read-only
Get one Conditional Access policy in full.
graph_get_named_location
Free · Read-only
Get one named location with its full definition.
graph_list_authentication_contexts
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_list_authentication_strength_policies
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_list_conditional_access_policies
Free · Read-only
List every Conditional Access policy in the tenant with its conditions and grant controls.
graph_list_named_locations
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_set_conditional_access_policy_state
Pro · Destructive
Turn a Conditional Access policy on, off, or into report-only mode.
graph_update_conditional_access_policy
Pro · Destructive
Update a Conditional Access policy's conditions or controls.
graph_update_named_location
Pro · Destructive
Update a named location's ranges, countries or trusted flag.

Administrative Units

ToolWhat it does
graph_add_administrative_unit_member
Pro · Write
Add a user, group or device to an administrative unit.
graph_add_administrative_unit_scoped_role
Pro · Destructive
Grant somebody an administrative role limited to this unit's members.
graph_create_administrative_unit
Pro · Write
Create an administrative unit.
graph_delete_administrative_unit
Pro · Destructive
Delete an administrative unit.
graph_get_administrative_unit
Free · Read-only
Get one administrative unit, including its membership rule if it has one and its visibility.
graph_list_administrative_unit_members
Free · Read-only
List the users, groups and devices inside an administrative unit.
graph_list_administrative_unit_scoped_role_members
Free · Read-only
List who holds an administrative role SCOPED to this unit — the people who can administer its members and nobody else.
graph_list_administrative_units
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_remove_administrative_unit_member
Pro · Destructive
Remove a user, group or device from an administrative unit.
graph_remove_administrative_unit_scoped_role
Pro · Destructive
Revoke somebody's administrative role over this unit.
graph_update_administrative_unit
Pro · Write
Update an administrative unit's name, description or visibility.
graph_update_administrative_unit_membership_rule
Pro · Destructive
Change the membership rule of a dynamic administrative unit.

Devices

ToolWhat it does
graph_add_device_registered_owner
Pro · Destructive
Register a user as an OWNER of a device.
graph_add_device_registered_user
Pro · Write
Register a user on a device — the record that this person uses this machine.
graph_delete_device
Pro · Destructive
Delete a device object from the directory.
graph_get_device
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_list_device_memberships
Free · Read-only
List the groups and administrative units a device belongs to DIRECTLY.
graph_list_device_registered_owners
Free · Read-only
List the registered OWNERS of a device — normally the person who joined it to the directory.
graph_list_device_registered_users
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_list_device_transitive_memberships
Free · Read-only
List every group and administrative unit a device belongs to, INCLUDING through nesting.
graph_list_devices
Free · Read-only
List the devices registered in a directory.
graph_remove_device_registered_owner
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_remove_device_registered_user
Pro · Destructive
Remove a user's registration on a device.
graph_set_device_account_enabled
Pro · Destructive
Enable or disable a device's directory account.
graph_update_device
Pro · Write
Update a device object's descriptive properties — its display name, operating system and version.

Intune Devices

ToolWhat it does
graph_bypass_activation_lock
Pro · Destructive
Remove Apple's Activation Lock from a supervised device so it can be set up under a different Apple Account.
graph_clean_windows_device
Pro · Destructive
Reset a Windows device to its factory settings, the 'Autopilot Reset / fresh start' action.
graph_create_device_category
Pro · Write
Create an Intune device category.
graph_delete_device_category
Pro · Destructive
Delete an Intune device category.
graph_delete_managed_device
Pro · Destructive
Delete a device's RECORD from Intune.
graph_delete_user_from_shared_apple_device
Pro · Destructive
Remove one named user's account and cached data from a shared iPad.
graph_disable_managed_device_lost_mode
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_get_detected_app
Free · Read-only
Get one detected application — its display name, version, publisher, size and the number of devices reporting it.
graph_get_device_category
Free · Read-only
Get one Intune device category by id — its display name and description.
graph_get_managed_device
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_get_managed_device_category
Free · Read-only
Get the device category assigned to one Intune-managed device.
graph_get_managed_device_protection_state
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_list_detected_app_devices
Free · Read-only
List the managed devices reporting a particular detected application.
graph_list_detected_apps
Free · Read-only
List the applications Intune has DETECTED across the enrolled fleet, with a device count for each.
graph_list_device_categories
Free · Read-only
List the Intune device categories defined in a tenant.
graph_list_managed_device_log_collections
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_list_managed_device_users
Free · Read-only
List the primary users associated with an Intune-managed device.
graph_list_managed_devices
Free · Read-only
List the devices enrolled in Intune.
graph_locate_managed_device
Pro · Write
Ask a supervised iOS/iPadOS or macOS device to report its location.
graph_logout_shared_apple_device_user
Pro · Destructive
Sign out whoever is currently signed in on a shared iPad.
graph_reboot_managed_device
Pro · Destructive
Restart a device now.
graph_recover_managed_device_passcode
Pro · Destructive
Ask a supervised device to surrender its current passcode to Intune.
graph_remote_lock_managed_device
Pro · Destructive
Lock a device remotely so it requires its passcode to be used again.
graph_request_remote_assistance
Pro · Write
Request a remote-assistance session for a device.
graph_reset_managed_device_passcode
Pro · Destructive
Remove or reset the passcode on a device.
graph_retire_managed_device
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_shut_down_managed_device
Pro · Destructive
Power a device off immediately.
graph_sync_managed_device
Pro · Write
Ask a device to check in with Intune immediately rather than waiting for its scheduled cycle.
graph_update_device_category
Pro · Write
Update an Intune device category's name or description.
graph_update_managed_device
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_windows_defender_scan
Pro · Write
Start a Microsoft Defender scan on a Windows device.
graph_windows_defender_update_signatures
Pro · Write
Tell a Windows device to update its Microsoft Defender malware signatures now.
graph_wipe_managed_device
Pro · Destructive
FACTORY-RESET a device.

Intune Configuration

ToolWhat it does
graph_assign_device_compliance_policy
Pro · Destructive
Set which groups a compliance policy applies to.
graph_assign_device_configuration
Pro · Destructive
Set which groups a configuration profile applies to.
graph_create_device_compliance_policy
Pro · Write
Create an Intune compliance policy.
graph_create_device_configuration
Pro · Write
Create an Intune configuration profile.
graph_delete_device_compliance_policy
Pro · Destructive
Delete an Intune compliance policy.
graph_delete_device_configuration
Pro · Destructive
Delete an Intune configuration profile.
graph_get_device_compliance_device_overview
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_get_device_compliance_policy
Free · Read-only
Get one Intune compliance policy in full, with every rule it evaluates.
graph_get_device_compliance_user_overview
Free · Read-only
Get the user-level summary for a compliance policy — the same verdict counts aggregated by person rather than by machine.
graph_get_device_configuration
Free · Read-only
Get one Intune configuration profile in full, including every setting it carries.
graph_get_device_configuration_device_overview
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_get_device_configuration_user_overview
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_get_oma_setting_secret
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_list_device_compliance_device_statuses
Free · Read-only
List each targeted device's verdict against a compliance policy, with the device name and when it last reported.
graph_list_device_compliance_policies
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_list_device_compliance_policy_assignments
Free · Read-only
List the groups a compliance policy is assigned to, including exclusions.
graph_list_device_compliance_scheduled_actions
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_list_device_compliance_user_statuses
Free · Read-only
List each targeted user's aggregated verdict against a compliance policy.
graph_list_device_configuration_assignments
Free · Read-only
List the groups a configuration profile is assigned to, including whether each assignment INCLUDES or EXCLUDES that group.
graph_list_device_configuration_device_statuses
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_list_device_configuration_user_statuses
Free · Read-only
List how a configuration profile landed for each targeted USER, aggregated across all of that person's devices.
graph_list_device_configurations
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_update_device_compliance_policy
Pro · Write
Update an Intune compliance policy.
graph_update_device_configuration
Pro · Write
Update an Intune configuration profile.

Intune Settings Catalog and Endpoint Security

ToolWhat it does
graph_assign_configuration_policy
Pro · Destructive
Set who a settings catalog or endpoint security policy applies to.
graph_assign_device_management_intent
Pro · Destructive
Set who an Intune intent applies to.
graph_get_configuration_policy
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_get_device_management_intent
Free · Read-only
Get one Intune intent with its settings and assignments expanded: what it sets, and who it reaches.
graph_get_device_policy_report
Free · Read-only
Collect a report started with graph_start_device_policy_report.
graph_list_configuration_policies
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_list_configuration_policy_assignments
Free · Read-only
List who one settings catalog or endpoint security policy is assigned to.
graph_list_configuration_policy_settings
Free · Read-only
List the settings inside one settings catalog or endpoint security policy.
graph_list_device_management_intent_assignments
Free · Read-only
List who one Intune intent is assigned to.
graph_list_device_management_intent_settings
Free · Read-only
List the settings of one Intune intent.
graph_list_device_management_intents
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_start_device_policy_report
Free · Read-only
Start the report of which configuration policies Intune has applied to one managed device, with each policy's status.

Mobility Management

ToolWhat it does
graph_list_mobility_management_policies
Free · Read-only
List a tenant's automatic enrollment policies, with includedGroups expanded: the Windows Automatic Enrollment settings.
graph_update_mdm_enrollment_policy
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

ToolWhat it does
graph_confirm_users_compromised
Pro · Write
Tell Entra ID Protection that these accounts really were compromised, setting each to confirmedCompromised at high risk.
graph_dismiss_user_risk
Pro · Write
Dismiss the risk on these accounts, setting each to dismissed at none.
graph_get_risk_detection
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_get_risky_user
Free · Read-only
Get one account's current risk verdict — level, state, detail and when it was last updated.
graph_list_risk_detections
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_list_risky_user_history
Free · Read-only
List how one account's risk state changed over time — every transition, what caused it, and the activity behind it.
graph_list_risky_users
Free · Read-only
List the accounts Entra ID Protection currently considers at risk.

Audit Logs

ToolWhat it does
graph_get_directory_audit
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_get_sign_in
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_list_directory_audits
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_list_provisioning_logs
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_list_sign_ins
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

ToolWhat it does
graph_check_member_objects
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_create_invitation
Pro · Destructive
Invite an external person into the directory as a B2B guest.
graph_get_available_extension_properties
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_get_directory_object
Free · Read-only
Get any directory object by its id without knowing what type it is.
graph_get_directory_objects_by_ids
Free · Read-only
Resolve many object ids to their directory objects in ONE call.
graph_get_member_groups
Free · Read-only
Return the ids of every GROUP a directory object belongs to, including through nesting.
graph_get_member_objects
Free · Read-only
Return the ids of every group, DIRECTORY ROLE and administrative unit a directory object belongs to, including through nesting.

Security

ToolWhat it does
graph_get_secure_score
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_get_secure_score_control_profile
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_get_security_alert
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_get_security_incident
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_list_insider_risk_alerts
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_list_secure_score_control_profiles
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_list_secure_scores
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_list_security_alerts
Free · Read-only
List Defender XDR alerts — individual detections from Defender for Endpoint, Office 365, Identity and Cloud Apps.
graph_list_security_incident_alerts
Free · Read-only
List the alerts Defender correlated into one incident — the evidence behind the story.
graph_list_security_incidents
Free · Read-only
List Defender XDR incidents — correlated groups of alerts, which is the right unit to triage from.
graph_run_hunting_query
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_update_secure_score_control_profile
Pro · Write
Record a tenant's own position on a Secure Score control — Default, Ignored, ThirdParty or Reviewed — with an optional note.
graph_update_security_alert
Pro · Write
Update an alert's status, classification, determination or assigned owner.
graph_update_security_incident
Pro · Write
Update an incident's status, classification, determination, assigned owner or display name.

Purview Labels

ToolWhat it does
graph_create_retention_label
Pro · Write
Create a Microsoft Purview retention label.
graph_delete_retention_label
Pro · Destructive
Delete a Microsoft Purview retention label permanently.
graph_get_retention_label
Free · Read-only
Get one Microsoft Purview retention label.
graph_get_sensitivity_label
Free · Read-only
Get one sensitivity label by id.
graph_list_retention_labels
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_list_sensitivity_labels
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_update_retention_label
Pro · Destructive
Update a Microsoft Purview retention label.

Usage Reports

ToolWhat it does
graph_report_email_activity_counts
Free · Read-only
Tenant-wide email totals per day — messages sent, received and read across the whole organization.
graph_report_email_activity_user_detail
Free · Read-only
Per-user email activity — send, receive and read counts, and each mailbox's last activity date.
graph_report_email_app_usage_user_detail
Free · Read-only
Which email CLIENTS each user actually connects with — Outlook desktop, Outlook mobile, Outlook Web, IMAP, POP, SMTP.
graph_report_m365_app_platform_user_counts
Free · Read-only
Daily counts of users active on each PLATFORM — Windows, Mac, mobile and web.
graph_report_m365_app_user_counts
Free · Read-only
Daily counts of users active in each Microsoft 365 app across the tenant.
graph_report_m365_app_user_detail
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_report_mailbox_usage_detail
Free · Read-only
Per-mailbox storage — bytes used against the quota, item count, and quota status.
graph_report_mailbox_usage_storage
Free · Read-only
Total mailbox storage consumed across the tenant, per day.
graph_report_office365_activation_counts
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_report_office365_activations_user_detail
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_report_office365_active_user_counts
Free · Read-only
Daily counts of active users per service across the tenant.
graph_report_office365_active_user_detail
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_report_office365_services_user_counts
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_report_onedrive_activity_user_detail
Free · Read-only
Per-user OneDrive activity — files viewed or edited, synced, shared internally and shared EXTERNALLY.
graph_report_onedrive_usage_account_detail
Free · Read-only
Per-account OneDrive storage — files, active files, bytes used against bytes allocated, and last activity.
graph_report_sharepoint_activity_user_detail
Free · Read-only
Per-user SharePoint activity — files viewed or edited, synced, shared internally and externally, and pages visited.
graph_report_sharepoint_site_usage_detail
Free · Read-only
Per-SITE SharePoint usage — storage used and allocated, file and page counts, visitors, and last activity.
graph_report_teams_device_usage_user_detail
Free · Read-only
Which DEVICES each person uses Teams from — Windows, Mac, iOS, Android, web and Linux.
graph_report_teams_user_activity_counts
Free · Read-only
Tenant-wide Teams totals per day — messages, meetings and calls across the organization.
graph_report_teams_user_activity_user_detail
Free · Read-only
Per-user Teams activity — channel messages, chat messages, meetings attended and organised, and calls.
graph_report_yammer_activity_user_detail
Free · Read-only
Per-user Viva Engage (formerly Yammer) activity — messages posted, read and liked, with last activity date.

Mail

ToolWhat it does
graph_copy_message
Pro · Write
Copy a message into another folder, leaving the original where it is.
graph_create_draft_message
Pro · Write
Create a message in the Drafts folder without sending it.
graph_create_forward_draft
Pro · Write
Create a forward DRAFT of a message, with its attachments, without sending it.
graph_create_mail_folder
Pro · Write
Create a mail folder, either at the top level or beneath an existing folder.
graph_create_message_rule
Pro · Destructive
Create a rule on the signed-in user's Inbox.
graph_create_reply_draft
Pro · Write
Create a reply DRAFT to a message — correctly threaded and addressed, quoting the original — without sending it.
graph_delete_mail_folder
Pro · Destructive
Delete a mail folder AND EVERYTHING IN IT, including its subfolders and every message they hold.
graph_delete_message
Pro · Destructive
Delete a message.
graph_delete_message_rule
Pro · Destructive
Delete an inbox rule permanently — there is no undo and no copy kept.
graph_download_message_attachment
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_forward_message
Pro · Destructive
Forward a message, with its attachments, to new recipients and send it immediately.
graph_get_mail_folder
Free · Read-only
Get one mail folder by id or by well-known name.
graph_get_mailbox_settings
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_get_message
Free · Read-only
Get one message in full, including its body and internet headers.
graph_get_message_attachment
Free · Read-only
Get one attachment as JSON.
graph_get_message_rule
Free · Read-only
Get one inbox rule in full.
graph_list_child_mail_folders
Free · Read-only
List the folders directly beneath one mail folder.
graph_list_mail_categories
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_list_mail_folder_messages
Free · Read-only
List the messages inside one mail folder, by folder id or well-known name.
graph_list_mail_folders
Free · Read-only
List the top-level mail folders in the signed-in user's mailbox, with unread and total item counts.
graph_list_message_attachments
Free · Read-only
List a message's attachments as METADATA — name, content type and size — without pulling any content down.
graph_list_message_rules
Free · Read-only
List every rule on the signed-in user's INBOX, with its conditions, actions and exceptions.
graph_list_messages
Free · Read-only
List messages in the signed-in user's mailbox, newest first unless you order them otherwise.
graph_move_message
Pro · Write
Move a message to another folder, by folder id or well-known name such as "archive", "junkemail" or "deleteditems".
graph_reply_all_to_message
Pro · Destructive
Reply to EVERYONE on a message — sender, To and CC — and send it immediately.
graph_reply_to_message
Pro · Destructive
Reply to a message's SENDER only and send it immediately.
graph_search_messages
Free · Read-only
Free-text search across the signed-in user's mailbox, including message bodies and the text of supported attachment types.
graph_send_draft_message
Pro · Destructive
Send a draft that already exists in the mailbox.
graph_send_mail
Pro · Destructive
Send a message immediately AS THE SIGNED-IN USER, from their real address.
graph_set_automatic_replies
Pro · Write
Turn the signed-in user's out-of-office automatic reply on, off, or on for a scheduled window.
graph_update_mail_folder
Pro · Write
Rename a mail folder.
graph_update_message
Pro · Write
Update a message's mutable properties — read state, importance and categories.
graph_update_message_rule
Pro · Destructive
Change an existing inbox rule.

Files

ToolWhat it does
graph_copy_drive_item
Pro · Write
Copy a file or folder, optionally into a different drive and optionally under a new name.
graph_create_folder
Pro · Write
Create a folder, in the drive's root or inside an existing folder.
graph_create_sharing_link
Pro · Destructive
Create a sharing link for a file or folder and RETURN THE URL.
graph_delete_drive_item
Pro · Destructive
Delete a file or folder.
graph_delete_item_permission
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_download_drive_item
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_get_drive
Free · Read-only
Get one drive, including its quota — total, used, remaining and the deleted bytes still held in the recycle bin.
graph_get_drive_item
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_get_drive_item_by_path
Free · Read-only
Get a file or folder by its path within the drive, for example "Documents/Invoices/2026-Q3.xlsx".
graph_invite_to_drive_item
Pro · Destructive
Grant named people access to a file or folder, optionally emailing them an invitation.
graph_list_drive_item_versions
Free · Read-only
List the stored versions of a file, newest first, with who saved each one and how large it was.
graph_list_drive_items
Free · Read-only
List the files and folders directly inside one folder, or inside the drive's root when no folder is named.
graph_list_drives
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_list_item_permissions
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_list_recent_files
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_list_shared_with_me
Free · Read-only
List files and folders other people have shared with the signed-in user.
graph_move_drive_item
Pro · Write
Move a file or folder to a different folder in the SAME drive, optionally renaming it on the way.
graph_rename_drive_item
Pro · Write
Rename a file or folder.
graph_restore_drive_item_version
Pro · Write
Restore a previous version of a file, making it the current content.
graph_search_drive_items
Free · Read-only
Search a drive for files and folders matching a term, across the whole hierarchy rather than one folder.
graph_update_item_permission
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

ToolWhat it does
graph_cancel_event
Pro · Destructive
Cancel a meeting the signed-in user ORGANISED, sending a cancellation notice to every attendee.
graph_create_calendar
Pro · Write
Create an additional calendar for the signed-in user.
graph_create_calendar_permission
Pro · Destructive
Share a calendar with somebody, choosing how much they can see.
graph_create_event
Pro · Destructive
Create an event.
graph_delete_calendar
Pro · Destructive
Delete a calendar AND EVERY EVENT IN IT.
graph_delete_calendar_permission
Pro · Destructive
Remove somebody's access to a calendar — the remediation when an audit finds a share that should not exist.
graph_delete_event
Pro · Destructive
Delete an event from the signed-in user's calendar.
graph_download_event_attachment
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_forward_event
Pro · Destructive
Forward a meeting invitation to additional people, who receive a real invitation and appear to the organiser as attendees.
graph_get_calendar
Free · Read-only
Get one calendar, or the signed-in user's default calendar when no id is given.
graph_get_event
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_get_schedule
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_list_calendar_permissions
Free · Read-only
List who a calendar is shared with and how much each of them can see.
graph_list_calendar_view
Free · Read-only
List the events occurring between two times, with recurring series EXPANDED into their individual occurrences.
graph_list_calendars
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_list_event_attachments
Free · Read-only
List an event's attachments as metadata — name, content type and size — without pulling any content down.
graph_list_event_instances
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_list_events
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_respond_to_event
Pro · Destructive
Answer a meeting invitation as the signed-in user — accept, decline, or accept tentatively.
graph_update_calendar
Pro · Write
Rename a calendar or change the colour Outlook shows it in.
graph_update_event
Pro · Destructive
Change an event.

Contacts

ToolWhat it does
graph_create_contact
Pro · Write
Add a contact to the signed-in user's personal address book, optionally inside a folder.
graph_delete_contact
Pro · Destructive
Delete a contact from the signed-in user's personal address book.
graph_get_contact
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_get_org_contact
Free · Read-only
Get one organizational contact from the directory.
graph_list_contact_folder_contacts
Free · Read-only
List the contacts inside one contact folder.
graph_list_contact_folders
Free · Read-only
List the folders the signed-in user files contacts into.
graph_list_contacts
Free · Read-only
List the signed-in user's personal Outlook contacts — their own private address book, not the organisation's shared directory.
graph_list_org_contacts
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_update_contact
Pro · Write
Change a personal contact.

SharePoint

ToolWhat it does
graph_create_list
Pro · Write
Create a new list in a SharePoint site.
graph_create_list_column
Pro · Write
Add a column to a SharePoint list.
graph_create_list_item
Pro · Write
Add a row to a SharePoint list.
graph_delete_list
Pro · Destructive
Delete a SharePoint list AND EVERY ITEM IN IT.
graph_delete_list_column
Pro · Destructive
Remove a column from a SharePoint list.
graph_delete_list_item
Pro · Destructive
Delete one row from a SharePoint list.
graph_get_list
Free · Read-only
Get one SharePoint list — its display name, template type, item count hints and whether it is hidden.
graph_get_list_item
Free · Read-only
Get one row of a SharePoint list with all its column values.
graph_get_root_site
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_get_site
Free · Read-only
Get one SharePoint site by its id.
graph_get_site_by_path
Free · Read-only
Resolve a SharePoint site from the address a person would paste from their browser, splitting it into its two halves.
graph_list_content_type_columns
Free · Read-only
List the columns a site content type contributes.
graph_list_list_columns
Free · Read-only
List the columns defined on one SharePoint list — their internal names, types, and whether each is required or read-only.
graph_list_list_item_versions
Free · Read-only
List the previous versions of one list item, each with who changed it and when.
graph_list_list_items
Free · Read-only
List the rows in a SharePoint list, WITH their column values.
graph_list_site_columns
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_list_site_content_types
Free · Read-only
List the content types defined on a SharePoint site.
graph_list_site_lists
Free · Read-only
List the lists in a SharePoint site.
graph_list_sites
Free · Read-only
List the SharePoint sites in the organisation.
graph_list_subsites
Free · Read-only
List the subsites directly under one SharePoint site.
graph_search_sites
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_update_list
Pro · Write
Rename a list or change its description.
graph_update_list_item
Pro · Write
Change column values on one row.

Teams

ToolWhat it does
graph_add_channel_member
Pro · Destructive
Add somebody to a PRIVATE or SHARED channel, granting them its whole history and its own files.
graph_add_team_member
Pro · Destructive
Add somebody to a team.
graph_archive_channel
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_archive_team
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_create_channel
Pro · Write
Add a channel to a team.
graph_create_team
Pro · Write
Create a new team.
graph_delete_channel
Pro · Destructive
Delete a channel AND ITS ENTIRE CONVERSATION HISTORY.
graph_get_channel
Free · Read-only
Get one channel — its description, its membershipType (standard, private or shared) and its web URL.
graph_get_channel_files_folder
Free · Read-only
Get the SharePoint folder holding a channel's files.
graph_get_channel_message
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_get_team
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_get_team_member
Free · Read-only
Get one team membership.
graph_list_all_channels
Free · Read-only
List EVERY channel in a team including private and shared ones, each with its membershipType.
graph_list_channel_members
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_list_channel_messages
Free · Read-only
List the top-level posts in a channel, newest first.
graph_list_channel_tabs
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_list_channels
Free · Read-only
List a team's STANDARD channels — the ones every member sees.
graph_list_joined_teams
Free · Read-only
List the teams the SIGNED-IN user belongs to.
graph_list_message_replies
Free · Read-only
List the replies to one channel post — the actual discussion, which the channel listing omits.
graph_list_team_installed_apps
Free · Read-only
List the Teams apps installed in a team.
graph_list_team_members
Free · Read-only
List a team's members.
graph_list_teams
Free · Read-only
List the teams in the organisation.
graph_remove_channel_member
Pro · Destructive
Remove somebody from a private or shared channel.
graph_remove_team_member
Pro · Destructive
Remove somebody from a team.
graph_reply_to_channel_message
Pro · Destructive
Reply to an existing channel post, in that post's thread.
graph_send_channel_message
Pro · Destructive
Post a message to a Teams channel.
graph_unarchive_channel
Pro · Write
Restore an archived channel, giving its members back the ability to post and edit.
graph_unarchive_team
Pro · Write
Restore an archived team to normal use.
graph_update_channel
Pro · Write
Rename a channel or change its description.
graph_update_team
Pro · Write
Change a team's name or description.
graph_update_team_member_role
Pro · Destructive
Promote a team member to owner, or demote an owner back to a member.

Chats & Presence

ToolWhat it does
graph_add_chat_member
Pro · Destructive
Add somebody to a group chat.
graph_get_chat
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_get_chat_message
Free · Read-only
Get one chat message in full — its body, sender, timestamps, attachments and mentions.
graph_get_presences
Free · Read-only
Get the Teams availability of up to 650 people in ONE call.
graph_get_user_presence
Free · Read-only
Get one person's Teams availability — Available, Busy, DoNotDisturb, Away or Offline, plus the activity behind it (InACall, InAMeeting, Presenting).
graph_list_chat_members
Free · Read-only
List who is in a chat.
graph_list_chat_messages
Free · Read-only
List the messages in one chat, newest first.
graph_list_chats
Free · Read-only
List the SIGNED-IN user's Teams chats — one-to-one, group and meeting conversations.
graph_list_pinned_chat_messages
Free · Read-only
List the messages pinned to the top of a chat.
graph_pin_chat_message
Pro · Write
Pin a message to the top of a chat so everyone in it sees it first.
graph_send_chat_message
Pro · Destructive
Send a message to an existing Teams chat.
graph_unpin_chat_message
Pro · Write
Remove a pin from a chat.

Intune Applications

ToolWhat it does
graph_assign_mobile_app
Pro · Destructive
Set which groups an app is deployed to.
graph_create_intune_role_assignment
Pro · Destructive
Grant an Intune role to one or more security groups.
graph_create_intune_role_definition
Pro · Write
Author a custom Intune administrator role.
graph_delete_intune_role_assignment
Pro · Destructive
Revoke an Intune role assignment.
graph_delete_intune_role_definition
Pro · Destructive
Delete a custom Intune role.
graph_get_intune_role_definition
Free · Read-only
Get one Intune role with its full permission list.
graph_get_managed_app_policy
Free · Read-only
Get one app protection or app configuration policy with all its settings.
graph_get_managed_app_registration
Free · Read-only
Get one app registration — which person, which app, which device, which platform version, and when it last checked in.
graph_get_mobile_app
Free · Read-only
Get one managed application in full.
graph_get_vpp_token
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_list_applied_app_policies
Free · Read-only
List the policies ACTUALLY IN FORCE for one app registration — what is really protecting that person's app right now.
graph_list_intended_app_policies
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_list_intune_role_assignments
Free · Read-only
List who holds one Intune role, and over which scope.
graph_list_intune_role_definitions
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_list_managed_app_policies
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_list_managed_app_registrations
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_list_managed_app_statuses
Free · Read-only
Get Intune's own summary reports on app protection — aggregate counts of users and apps by policy state.
graph_list_mobile_app_assignments
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_list_mobile_apps
Free · Read-only
List the applications Intune manages — store apps, line-of-business packages and web links across every platform.
graph_list_vpp_tokens
Pro · Destructive
List the Apple Volume Purchase Program tokens uploaded to Intune, INCLUDING EACH TOKEN'S VALUE.
graph_target_managed_app_policy
Pro · Destructive
Set which apps an app protection policy covers.
graph_update_intune_role_assignment
Pro · Destructive
Change an existing Intune role assignment's members or scope.
graph_update_intune_role_definition
Pro · Destructive
Change a custom Intune role's name, description or permissions.

Partner Center (CSP)

ToolWhat it does
graph_get_partner_customer
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_get_partner_customer_usage_records
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_get_partner_invoice
Free · Read-only
Get one invoice's header — billing period, totals by currency, due date and the document links.
graph_get_partner_order
Free · Read-only
Get one CSP order by id, with its line items, quantities, offer ids and current status.
graph_get_partner_service_request
Free · Read-only
Get one Microsoft service request in full — its status, severity, product area and the support engineer's notes.
graph_get_partner_subscription
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_get_partner_subscription_resource_usage_records
Free · Read-only
Break one Azure subscription's current-period spend down by resource.
graph_list_partner_customer_orders
Free · Read-only
List the orders placed for a CSP customer — what was bought, when, at what quantity and on which billing cycle.
graph_list_partner_customer_service_requests
Free · Read-only
List the Microsoft support tickets raised on a customer's behalf, with their status and severity.
graph_list_partner_customer_subscriptions
Free · Read-only
List everything a CSP customer is subscribed to — offer, quantity, billing cycle, term, status and renewal settings.
graph_list_partner_customers
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_list_partner_invoice_line_items
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_list_partner_invoices
Free · Read-only
List the partner's own invoices from Microsoft — invoice id, billing period, currency, total and payment status.
graph_list_partner_subscriptions_by_order
Free · Read-only
List the subscriptions one order produced.
graph_search_partner_customers
Free · Read-only
Find CSP customers whose company name starts with a given string.

Partner Center Commerce

ToolWhat it does
graph_change_partner_subscription_quantity
Pro · Destructive
Change the license quantity of a customer's subscription.
graph_checkout_partner_cart
Pro · Destructive
Check out a customer's cart: Partner Center places the orders and the customer is billed.
graph_create_partner_cart
Pro · Write
Create a cart for a customer: the products to buy, their quantities, billing cycles and terms.
graph_get_partner_cart
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_list_partner_product_skus
Free · Read-only
List the SKUs of one catalog product in one country, from graph_list_partner_products.
graph_list_partner_products
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_list_partner_sku_availabilities
Free · Read-only
List the availabilities of one SKU in one country.
graph_update_partner_cart
Pro · Write
Replace the lines of a customer's cart.

Lighthouse Tenants

ToolWhat it does
graph_assign_lighthouse_tenant_tag
Pro · Write
Attach a Lighthouse tag to one or more managed tenants.
graph_create_lighthouse_tenant_tag
Pro · Write
Create a tag you can attach to managed tenants in Microsoft 365 Lighthouse, to group customers for reporting and management.
graph_delete_lighthouse_tenant_tag
Pro · Destructive
Delete a Lighthouse tenant tag.
graph_get_lighthouse_audit_event
Free · Read-only
Get one Lighthouse audit event record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_tenant
Free · Read-only
Get one managed tenant record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_tenant_customized_information
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_get_lighthouse_tenant_detailed_information
Free · Read-only
Get one tenant detailed information records (verified domains, size, region, license counts) record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_tenant_group
Free · Read-only
Get one tenant group record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_tenant_tag
Free · Read-only
Get one tenant tag record from Microsoft 365 Lighthouse by its id.
graph_list_lighthouse_audit_events
Free · Read-only
List Lighthouse audit events across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_my_roles
Free · Read-only
List the signed-in user's own role assignments in each managed tenant, as Lighthouse sees them.
graph_list_lighthouse_tenant_customized_information
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_list_lighthouse_tenant_detailed_information
Free · Read-only
List tenant detailed information records (verified domains, size, region, license counts) across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_tenant_groups
Free · Read-only
List tenant groups across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_tenant_tags
Free · Read-only
List tenant tags across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_tenant_usage
Free · Read-only
List per-service usage figures across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_tenants
Free · Read-only
List managed tenants across the customers you manage in Microsoft 365 Lighthouse.
graph_offboard_lighthouse_tenant
Pro · Destructive
Offboard a managed customer tenant from Microsoft 365 Lighthouse.
graph_reset_lighthouse_tenant_onboarding
Pro · Destructive
Reset a managed customer tenant's onboarding status in Lighthouse so the onboarding can be run again.
graph_search_lighthouse_tenant_groups
Free · Read-only
Find the tenant groups a managed tenant belongs to.
graph_unassign_lighthouse_tenant_tag
Pro · Destructive
Detach a Lighthouse tag from one or more managed tenants.
graph_update_lighthouse_tenant_customized_information
Pro · Write
Change the website or contacts you keep for one managed customer in Lighthouse.
graph_update_lighthouse_tenant_tag
Pro · Write
Rename a Lighthouse tenant tag or change its description.

Lighthouse Insights

ToolWhat it does
graph_get_lighthouse_cloud_pc_connection
Free · Read-only
Get one record of Cloud PC connection health results from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_cloud_pc_device
Free · Read-only
Get one record of Windows 365 Cloud PC devices from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_cloud_pc_overview
Free · Read-only
Get one record of Windows 365 Cloud PC overview figures from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_compliance_setting_state_summary
Free · Read-only
Get one record of device compliance policy setting state summaries from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_conditional_access_policy_coverage
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_get_lighthouse_credential_user_registration_summary
Free · Read-only
Get one record of MFA and self-service password reset registration summaries from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_managed_device_compliance
Free · Read-only
Get one record of managed device compliance records from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_managed_device_compliance_trend
Free · Read-only
Get one record of managed device compliance trend points from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_windows_device_malware_state
Free · Read-only
Get one record of malware states of Windows devices registered with Intune from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_windows_protection_state
Free · Read-only
Get one record of protection states of Windows devices registered with Intune from Microsoft 365 Lighthouse by its id.
graph_list_lighthouse_aggregated_policy_compliances
Free · Read-only
List aggregated device compliance policy results across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_cloud_pc_connections
Free · Read-only
List Cloud PC connection health results across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_cloud_pc_devices
Free · Read-only
List Windows 365 Cloud PC devices across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_cloud_pcs_overview
Free · Read-only
List Windows 365 Cloud PC overview figures across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_compliance_setting_state_summaries
Free · Read-only
List device compliance policy setting state summaries across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_conditional_access_policy_coverages
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_list_lighthouse_credential_user_registration_summaries
Free · Read-only
List MFA and self-service password reset registration summaries across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_managed_device_compliance_trends
Free · Read-only
List managed device compliance trend points across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_managed_device_compliances
Free · Read-only
List managed device compliance records across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_windows_device_malware_states
Free · Read-only
List malware states of Windows devices registered with Intune across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_windows_protection_states
Free · Read-only
List protection states of Windows devices registered with Intune across the customers you manage in Microsoft 365 Lighthouse.

Lighthouse Baselines

ToolWhat it does
graph_apply_lighthouse_management_action
Pro · Destructive
Apply a baseline management action to a managed tenant or a tenant group.
graph_change_lighthouse_deployment_status
Pro · Destructive
Change the deployment status of a management action in a managed tenant, for example to pause or resume a baseline rollout.
graph_get_lighthouse_management_action
Free · Read-only
Get one baseline management action record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_management_action_deployment_status
Free · Read-only
Get one tenant-level deployment statuses of management action record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_management_intent
Free · Read-only
Get one baseline management intent record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_management_template
Free · Read-only
Get one baseline management template record from Microsoft 365 Lighthouse by its id.
graph_list_lighthouse_management_action_deployment_statuses
Free · Read-only
List tenant-level deployment statuses of management actions across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_management_actions
Free · Read-only
List baseline management actions across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_management_intents
Free · Read-only
List baseline management intents across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_management_templates
Free · Read-only
List baseline management templates across the customers you manage in Microsoft 365 Lighthouse.

Lighthouse Alerts

ToolWhat it does
graph_get_lighthouse_alert
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_get_lighthouse_alert_log
Free · Read-only
Get one managed tenant alert logs (what happened to each alert) record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_alert_rule
Free · Read-only
Get one managed tenant alert rules (the rules that raise those alerts) record from Microsoft 365 Lighthouse by its id.
graph_get_lighthouse_alert_rule_definition
Free · Read-only
Get one managed tenant alert rule definitions (the built-in rule catalog) record from Microsoft 365 Lighthouse by its id.
graph_list_lighthouse_alert_logs
Free · Read-only
List managed tenant alert logs (what happened to each alert) across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_alert_rule_definitions
Free · Read-only
List managed tenant alert rule definitions (the built-in rule catalog) across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_alert_rules
Free · Read-only
List managed tenant alert rules (the rules that raise those alerts) across the customers you manage in Microsoft 365 Lighthouse.
graph_list_lighthouse_alerts
Free · Read-only
List managed tenant alerts (alerts Lighthouse raised for the customers you manage) across the customers you manage in Microsoft 365 Lighthouse.
ToolWhat it does
graph_get_audit_log_search
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_list_audit_log_search_records
Free · Read-only
List the audit records a finished search matched.
graph_list_audit_log_searches
Free · Read-only
List the audit log searches that exist in the tenant, with their status.
graph_start_audit_log_search
Free · Read-only
Start a Microsoft Purview audit log search.

Service Health and Message Center

ToolWhat it does
graph_archive_message_center_messages
Pro · Write
For the signed-in user, archive Message center posts.
graph_download_message_center_attachment
Free · Read-only
Download the content of one Message center attachment.
graph_download_service_health_incident_report
Free · Read-only
Download the post-incident report Microsoft publishes for a resolved service health issue.
graph_favorite_message_center_messages
Pro · Write
For the signed-in user, mark Message center posts as favorites.
graph_get_message_center_attachment
Free · Read-only
Get the metadata of one Message center attachment.
graph_get_message_center_message
Free · Read-only
Get one Message center post by id, with its body, category, severity, action-required date and attachments flag.
graph_get_service_health
Free · Read-only
Get the health overview of one Microsoft 365 service by its name, optionally with its issues expanded.
graph_get_service_health_issue
Free · Read-only
Get one service health issue by id, with its impact description, status and update history.
graph_list_message_center_attachments
Free · Read-only
List the attachments of one Message center post (metadata only: name, size, last modified).
graph_list_message_center_messages
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_list_service_health_issues
Free · Read-only
List service health issues (incidents and advisories) across Microsoft 365 services.
graph_list_service_health_overviews
Free · Read-only
List the health of each Microsoft 365 service for the organization: one overview per service with its current status.
graph_mark_read_message_center_messages
Pro · Write
For the signed-in user, mark Message center posts as read.
graph_mark_unread_message_center_messages
Pro · Write
For the signed-in user, mark Message center posts as unread.
graph_unarchive_message_center_messages
Pro · Write
For the signed-in user, move archived Message center posts back to the inbox.
graph_unfavorite_message_center_messages
Pro · Write
For the signed-in user, remove the favorite mark from Message center posts.

Windows 365 Cloud PCs

ToolWhat it does
graph_create_cloud_pc_snapshot
Pro · Write
Create a restore snapshot of a Windows 365 Cloud PC in a storage account.
graph_end_cloud_pc_grace_period
Pro · Destructive
End the grace period of a Windows 365 Cloud PC whose license was removed.
graph_get_cloud_pc
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_get_cloud_pc_connectivity_history
Free · Read-only
Get the connectivity history of a Windows 365 Cloud PC: when it was reachable or not, and why.
graph_get_cloud_pc_launch_detail
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_list_cloud_pc_remote_action_results
Free · Read-only
List the results of the remote actions run on a Windows 365 Cloud PC.
graph_list_cloud_pc_service_plans
Free · Read-only
List the Windows 365 service plans (sizes) available to the organization, with vCPU, RAM and storage.
graph_list_cloud_pc_snapshots
Free · Read-only
List the restore snapshots of a Windows 365 Cloud PC.
graph_list_cloud_pc_supported_remote_actions
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_list_cloud_pcs
Free · Read-only
List the Windows 365 Cloud PCs in the directory with their status, user, provisioning policy and service plan.
graph_power_off_cloud_pc
Pro · Destructive
Power off a Windows 365 Cloud PC.
graph_power_on_cloud_pc
Pro · Write
Power on a Windows 365 Cloud PC.
graph_reboot_cloud_pc
Pro · Destructive
Reboot a Windows 365 Cloud PC.
graph_rename_cloud_pc
Pro · Write
Change the display name of a Windows 365 Cloud PC.
graph_reprovision_cloud_pc
Pro · Destructive
Reprovision a Windows 365 Cloud PC: rebuild it from its provisioning policy image.
graph_resize_cloud_pc
Pro · Destructive
Change the service plan (size) of a Windows 365 Cloud PC.
graph_restore_cloud_pc
Pro · Destructive
Restore a Windows 365 Cloud PC to an earlier snapshot.
graph_troubleshoot_cloud_pc
Pro · Write
Start Microsoft's troubleshooting check on a Windows 365 Cloud PC that cannot be reached.

Windows 365 Policies

ToolWhat it does
graph_assign_cloud_pc_provisioning_policy
Pro · Destructive
Assign a Windows 365 provisioning policy to groups.
graph_assign_cloud_pc_user_setting
Pro · Destructive
Assign a Windows 365 user setting to groups.
graph_create_cloud_pc_device_image
Pro · Write
Upload an Azure virtual machine image as a custom Windows 365 device image.
graph_create_cloud_pc_on_premises_connection
Pro · Write
Create a Windows 365 on-premises network connection.
graph_create_cloud_pc_provisioning_policy
Pro · Write
Create a Windows 365 provisioning policy.
graph_create_cloud_pc_user_setting
Pro · Write
Create a Windows 365 user setting.
graph_delete_cloud_pc_device_image
Pro · Destructive
Delete a custom Windows 365 device image.
graph_delete_cloud_pc_on_premises_connection
Pro · Destructive
Delete a Windows 365 on-premises network connection.
graph_delete_cloud_pc_provisioning_policy
Pro · Destructive
Delete a Windows 365 provisioning policy.
graph_delete_cloud_pc_user_setting
Pro · Destructive
Delete a Windows 365 user setting.
graph_get_cloud_pc_device_image
Free · Read-only
Get one custom Windows 365 device image, with its upload status.
graph_get_cloud_pc_gallery_image
Free · Read-only
Get one Windows 365 gallery image.
graph_get_cloud_pc_on_premises_connection
Free · Read-only
Get one Windows 365 on-premises network connection, including its health check status.
graph_get_cloud_pc_provisioning_policy
Free · Read-only
Get one Windows 365 provisioning policy, optionally with its assignments expanded.
graph_get_cloud_pc_user_setting
Free · Read-only
Get one Windows 365 user setting, optionally with its assignments expanded.
graph_list_cloud_pc_device_images
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_list_cloud_pc_gallery_images
Free · Read-only
List the Microsoft-provided Windows 365 gallery images a provisioning policy can use.
graph_list_cloud_pc_on_premises_connections
Free · Read-only
List the Windows 365 on-premises network connections: the Azure virtual network, subnet and domain join account Cloud PCs use.
graph_list_cloud_pc_provisioning_policies
Free · Read-only
List the Windows 365 provisioning policies: image, region and join type used to create Cloud PCs.
graph_list_cloud_pc_source_images
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_list_cloud_pc_user_settings
Free · Read-only
List the Windows 365 user settings: local admin, reset and restore point settings applied to groups of users.
graph_run_cloud_pc_on_premises_connection_health_checks
Pro · Write
Start the health checks of a Windows 365 on-premises network connection (DNS, domain join, endpoint reachability).
graph_update_cloud_pc_on_premises_connection
Pro · Destructive
Change a Windows 365 on-premises network connection.
graph_update_cloud_pc_on_premises_connection_domain_password
Pro · Destructive
Replace the Active Directory domain join account password stored on a Windows 365 on-premises network connection.
graph_update_cloud_pc_provisioning_policy
Pro · Destructive
Change a Windows 365 provisioning policy.
graph_update_cloud_pc_user_setting
Pro · Destructive
Change a Windows 365 user setting.

Windows 365 Reports

ToolWhat it does
graph_count_cloud_pcs_by_status
Free · Read-only
Count the Windows 365 Cloud PCs by status.
graph_get_action_status_report
Free · Read-only
Get a Windows 365 report on the status of remote actions run on Cloud PCs.
graph_get_bulk_action_status_report
Free · Read-only
Get a Windows 365 report on the status of bulk actions on Cloud PCs.
graph_get_cloud_pc_audit_event
Free · Read-only
Get one Windows 365 audit event.
graph_get_cloud_pc_bulk_action
Free · Read-only
Get one Windows 365 bulk action with the per-Cloud PC status.
graph_get_cloud_pc_organization_settings
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_get_cloud_pc_recommendation_report
Free · Read-only
Get the Windows 365 recommendation report: which Cloud PCs Microsoft suggests resizing based on usage.
graph_get_cloud_pc_report_export
Free · Read-only
Get a Windows 365 report export job by id: its status and, once complete, the download URL.
graph_get_cloud_pc_tenant_encryption_setting
Free · Read-only
Get the Windows 365 tenant encryption setting (platform-managed or customer-managed keys).
graph_get_connection_quality_report
Free · Read-only
Get a Windows 365 report on the connection quality (round-trip time, bandwidth) of Cloud PC sessions.
graph_get_daily_remote_connection_report
Free · Read-only
Get a Windows 365 report on remote connections to Cloud PCs aggregated by day.
graph_get_inaccessible_report
Free · Read-only
Get a Windows 365 report on the Cloud PCs users cannot reach.
graph_get_remote_connection_history_report
Free · Read-only
Get a Windows 365 report on the history of remote connections to Cloud PCs.
graph_get_shared_use_license_report
Free · Read-only
Get a Windows 365 report on shared-use Windows 365 license usage.
graph_get_tenant_metrics_report
Free · Read-only
Get a Windows 365 report on tenant-level Windows 365 metrics.
graph_get_total_remote_connection_report
Free · Read-only
Get a Windows 365 report on remote connections to Cloud PCs aggregated in total.
graph_get_troubleshoot_report
Free · Read-only
Get a Windows 365 report on the results of Cloud PC troubleshooting runs.
graph_list_cloud_pc_audit_activity_types
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_list_cloud_pc_audit_events
Free · Read-only
List the Windows 365 audit events: who changed what in Windows 365 and when.
graph_list_cloud_pc_bulk_actions
Free · Read-only
List the bulk actions run on Windows 365 Cloud PCs.
graph_list_cloud_pc_supported_regions
Free · Read-only
List the regions where Windows 365 can provision Cloud PCs, with their availability.
graph_start_cloud_pc_report_export
Free · Read-only
Start an export job for a Windows 365 report.
graph_update_cloud_pc_organization_settings
Pro · Destructive
Change the tenant-wide Windows 365 settings.

eDiscovery Cases

ToolWhat it does
graph_add_ediscovery_case_member
Pro · Destructive
Add a user or a role group to an eDiscovery case.
graph_close_ediscovery_case
Pro · Destructive
Close an eDiscovery case.
graph_create_ediscovery_case
Pro · Destructive
Create an eDiscovery case.
graph_delete_ediscovery_case
Pro · Destructive
Delete an eDiscovery case.
graph_get_ediscovery_case
Free · Read-only
Get one eDiscovery case: name, status, description, dates and the people who created and last changed it.
graph_get_ediscovery_case_operation
Free · Read-only
Get one eDiscovery case operation: its action, status (notStarted, running, succeeded, partiallySucceeded, failed), result and times.
graph_get_ediscovery_case_settings
Free · Read-only
Get the settings of an eDiscovery case: case type, OCR, redundancy detection, topic modeling and review set grouping.
graph_list_ediscovery_case_members
Free · Read-only
List the members of an eDiscovery case (users and role groups).
graph_list_ediscovery_case_operations
Free · Read-only
List the operations of an eDiscovery case (indexing, estimates, exports, purges, review set loads, hold updates) with their status.
graph_list_ediscovery_cases
Free · Read-only
List the Microsoft Purview eDiscovery cases the signed-in user can see, with status, description and dates.
graph_remove_ediscovery_case_member
Pro · Destructive
Remove a member from an eDiscovery case.
graph_reopen_ediscovery_case
Pro · Destructive
Reopen an eDiscovery case that was closed.
graph_reset_ediscovery_case_settings
Pro · Destructive
Reset an eDiscovery case's settings to Microsoft's defaults.
graph_update_ediscovery_case
Pro · Destructive
Change an eDiscovery case's name, description or external id.
graph_update_ediscovery_case_settings
Pro · Destructive
Change the settings of an eDiscovery case.

eDiscovery Custodians and Data Sources

ToolWhat it does
graph_activate_ediscovery_custodian
Pro · Destructive
Reactivate a released custodian in a case.
graph_apply_hold_to_ediscovery_custodians
Pro · Destructive
Start applying the case's legal hold to custodians.
graph_apply_hold_to_ediscovery_noncustodial_sources
Pro · Destructive
Start applying the case's legal hold to non-custodial data sources.
graph_create_ediscovery_custodian
Pro · Destructive
Add a person to an eDiscovery case as a custodian, by their primary email address.
graph_create_ediscovery_custodian_group_source
Pro · Destructive
Add a Microsoft 365 group (its mailbox, its site or both) to a custodian by the group's email address.
graph_create_ediscovery_custodian_site_source
Pro · Destructive
Add a SharePoint site to a custodian.
graph_create_ediscovery_custodian_user_source
Pro · Destructive
Add a mailbox or OneDrive source to a custodian.
graph_create_ediscovery_noncustodial_source
Pro · Destructive
Add a mailbox or a site to a case without a custodian.
graph_delete_ediscovery_custodian_site_source
Pro · Destructive
Remove a site source from a custodian.
graph_delete_ediscovery_custodian_user_source
Pro · Destructive
Remove a user source from a custodian.
graph_get_ediscovery_custodian
Free · Read-only
Get one custodian: email, status, hold status, acknowledgment and dates.
graph_get_ediscovery_custodian_last_index_operation
Free · Read-only
Get the last index operation of a custodian: status and times.
graph_get_ediscovery_noncustodial_source
Free · Read-only
Get one non-custodial data source: its source, status and hold status.
graph_get_ediscovery_noncustodial_source_last_index_operation
Free · Read-only
Get the last index operation of a non-custodial data source: status and times.
graph_list_ediscovery_custodian_group_sources
Free · Read-only
List the Microsoft 365 group sources of a custodian.
graph_list_ediscovery_custodian_site_sources
Free · Read-only
List the SharePoint site sources of a custodian.
graph_list_ediscovery_custodian_user_sources
Free · Read-only
List the mailbox and OneDrive sources of a custodian.
graph_list_ediscovery_custodians
Free · Read-only
List the custodians of an eDiscovery case with their status and hold status.
graph_list_ediscovery_noncustodial_sources
Free · Read-only
List the non-custodial data sources of a case (mailboxes and sites that are not tied to a custodian).
graph_release_ediscovery_custodian
Pro · Destructive
Release a custodian from a case.
graph_release_ediscovery_noncustodial_source
Pro · Destructive
Release a non-custodial data source from a case.
graph_remove_hold_from_ediscovery_custodians
Pro · Destructive
Start removing the case's legal hold from custodians.
graph_remove_hold_from_ediscovery_noncustodial_sources
Pro · Destructive
Start removing the case's legal hold from non-custodial data sources.
graph_update_ediscovery_custodian_index
Pro · Destructive
Start an index operation that makes a custodian and its sources searchable.
graph_update_ediscovery_noncustodial_source_index
Pro · Destructive
Start an index operation that makes a non-custodial data source searchable.

eDiscovery Searches

ToolWhat it does
graph_add_ediscovery_search_additional_source
Pro · Destructive
Add one mailbox or one site to a search without making it a custodian source.
graph_add_ediscovery_search_custodian_source
Pro · Destructive
Add a custodian source (a user, site or group source of a case custodian) to a search.
graph_add_ediscovery_search_noncustodial_source
Pro · Destructive
Add a non-custodial data source to a search.
graph_create_ediscovery_search
Pro · Destructive
Create a search in an eDiscovery case.
graph_delete_ediscovery_search
Pro · Destructive
Delete an eDiscovery search.
graph_estimate_ediscovery_search_statistics
Pro · Destructive
Run an estimate of an eDiscovery search: how many items and how much data it finds, and in which locations.
graph_export_ediscovery_search_report
Pro · Destructive
Export the item report of an estimated eDiscovery search (the list of items, without the items).
graph_export_ediscovery_search_results
Pro · Destructive
Export the results of an estimated eDiscovery search to a PST or MSG package in Purview.
graph_get_ediscovery_search
Free · Read-only
Get one search: name, KQL query, data source scopes and dates.
graph_get_ediscovery_search_last_estimate
Free · Read-only
Get the last estimate of a search: status, item and size counts, and the unindexed counts.
graph_list_ediscovery_search_additional_sources
Free · Read-only
List the additional sources (single mailboxes or sites) added to a search.
graph_list_ediscovery_search_custodian_sources
Free · Read-only
List the custodian sources a search runs over.
graph_list_ediscovery_search_noncustodial_sources
Free · Read-only
List the non-custodial data sources a search runs over.
graph_list_ediscovery_searches
Free · Read-only
List the searches of an eDiscovery case with their KQL query and scope.
graph_purge_ediscovery_search_data
Pro · Destructive
Delete the content that an eDiscovery search found.
graph_remove_ediscovery_search_custodian_source
Pro · Destructive
Remove a custodian source from a search.
graph_remove_ediscovery_search_noncustodial_source
Pro · Destructive
Remove a non-custodial data source from a search.
graph_update_ediscovery_search
Pro · Destructive
Change an eDiscovery search's name, description, KQL query or data source scopes.

eDiscovery Review Sets, Tags and Holds

ToolWhat it does
graph_add_to_ediscovery_review_set
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_apply_tags_to_ediscovery_review_set_query
Pro · Destructive
Add tags to, or remove tags from, every file a review set query finds.
graph_create_ediscovery_legal_hold
Pro · Destructive
Create a legal hold policy in an eDiscovery case.
graph_create_ediscovery_legal_hold_site_source
Pro · Destructive
Put a SharePoint site under a legal hold.
graph_create_ediscovery_legal_hold_user_source
Pro · Destructive
Put a user's mailbox, OneDrive or both under a legal hold.
graph_create_ediscovery_review_set
Pro · Destructive
Create a review set in an eDiscovery case.
graph_create_ediscovery_review_set_query
Pro · Destructive
Save a KQL query on a review set.
graph_create_ediscovery_tag
Pro · Destructive
Create a review tag.
graph_delete_ediscovery_legal_hold
Pro · Destructive
Delete a legal hold policy.
graph_delete_ediscovery_legal_hold_site_source
Pro · Destructive
Take a SharePoint site off a legal hold.
graph_delete_ediscovery_legal_hold_user_source
Pro · Destructive
Take a user's mailbox or OneDrive off a legal hold.
graph_delete_ediscovery_review_set_query
Pro · Destructive
Delete a saved review set query.
graph_delete_ediscovery_tag
Pro · Destructive
Remove a review tag.
graph_disable_ediscovery_legal_hold_policy
Pro · Destructive
Disable a legal hold policy, which releases the hold across all its data sources in one operation.
graph_enable_ediscovery_legal_hold_policy
Pro · Destructive
Enable a legal hold policy so the hold applies to all its data sources in one operation.
graph_export_ediscovery_review_set
Pro · Destructive
Export the files of a review set from Purview.
graph_export_ediscovery_review_set_query
Pro · Destructive
Export the files a review set query finds.
graph_get_ediscovery_legal_hold
Free · Read-only
Get one legal hold policy: name, KQL content query, status and errors.
graph_get_ediscovery_review_set
Free · Read-only
Get one review set: name, description and dates.
graph_get_ediscovery_review_set_file
Free · Read-only
Get one file of an eDiscovery review set with its metadata.
graph_get_ediscovery_review_set_query
Free · Read-only
Get one saved review set query: name and KQL.
graph_get_ediscovery_tag
Free · Read-only
Get one review tag: name, description and child selectability.
graph_get_ediscovery_tags_as_hierarchy
Free · Read-only
Get the review tags of a case as a parent and child tree.
graph_list_ediscovery_legal_hold_site_sources
Free · Read-only
List the SharePoint sites a legal hold covers.
graph_list_ediscovery_legal_hold_user_sources
Free · Read-only
List the mailboxes and OneDrives a legal hold covers.
graph_list_ediscovery_legal_holds
Free · Read-only
List the legal hold policies of an eDiscovery case with their status and query.
graph_list_ediscovery_review_set_files
Free · Read-only
List the files in an eDiscovery review set: name, size, dates, sender and recipients, tags and the extracted text status.
graph_list_ediscovery_review_set_queries
Free · Read-only
List the saved queries of a review set.
graph_list_ediscovery_review_sets
Free · Read-only
List the review sets of an eDiscovery case.
graph_list_ediscovery_tags
Free · Read-only
List the review tags of an eDiscovery case.
graph_retry_ediscovery_legal_hold_policy
Pro · Destructive
Ask Purview to retry a legal hold policy that failed to deploy.
graph_run_ediscovery_review_set_query
Free · Read-only
Run a saved review set query and return the files it finds.
graph_update_ediscovery_legal_hold
Pro · Destructive
Change a legal hold's description or KQL query.
graph_update_ediscovery_review_set
Pro · Destructive
Change a review set's name or description.
graph_update_ediscovery_review_set_query
Pro · Destructive
Change a saved review set query.
graph_update_ediscovery_tag
Pro · Destructive
Change a review tag.

Copilot Settings

ToolWhat it does
graph_get_copilot_limited_mode
Free · Read-only
Get the Copilot limited mode setting for Teams meetings: whether it is on and the group it applies to.
graph_get_copilot_policy_setting
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_update_copilot_limited_mode
Pro · Destructive
Turn Copilot limited mode in Teams meetings on or off for one group.
graph_update_copilot_policy_setting
Pro · Destructive
Change one Copilot setting in the tenant-level policy.

Copilot Cost Management

ToolWhat it does
graph_add_copilot_spending_alert_recipient
Pro · Write
Add a user as a recipient of a Copilot spending policy's alerts.
graph_add_copilot_spending_policy_group
Pro · Destructive
Add a group to a selected-groups Copilot spending policy.
graph_add_copilot_spending_policy_service
Pro · Destructive
Add a governed service to a Copilot spending policy, enabled or disabled.
graph_create_copilot_spending_policy
Pro · Destructive
Create a Copilot spending policy that caps credit consumption for all users or for selected groups.
graph_decide_copilot_credit_request
Pro · Destructive
Approve or reject one pending Copilot credit request.
graph_decide_copilot_credit_requests
Pro · Destructive
Approve or reject up to 100 Copilot credit requests in one call.
graph_delete_copilot_spending_alert_settings
Pro · Destructive
Delete the alert configuration of a Copilot spending policy, which turns its alerts off.
graph_delete_copilot_spending_policy
Pro · Destructive
Delete a Copilot spending policy.
graph_get_copilot_credit_request
Free · Read-only
Get one Copilot credit request with its strong ETag.
graph_get_copilot_group_usage_record
Free · Read-only
Get one group's Copilot credit consumption for one completed UTC day.
graph_get_copilot_service_usage_record
Free · Read-only
Get one service's Copilot credit consumption for one completed UTC day.
graph_get_copilot_spending_alert_settings
Free · Read-only
Get the notify-only alert configuration of a Copilot spending policy: whether alerts are on and their thresholds.
graph_get_copilot_spending_policy
Free · Read-only
Get one Copilot spending policy: its limits, billing methods, status and ETag.
graph_get_copilot_spending_policy_service
Free · Read-only
Get one service setting of a Copilot spending policy, with the policy's ETag (parentEtag).
graph_get_copilot_tenant_credit_balance
Free · Read-only
Get the tenant-wide Copilot credit balance snapshot, one row per billing method.
graph_get_copilot_user_credit_balance
Free · Read-only
Get one user's Copilot credit consumption balance and the spending policy that governs them.
graph_get_copilot_user_service_balance
Free · Read-only
Get one user's Copilot balance row for one governed service.
graph_get_copilot_user_usage_detail
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_get_copilot_user_usage_record
Free · Read-only
Get one user's Copilot credit consumption for one completed UTC day.
graph_list_copilot_credit_requests
Free · Read-only
List users' requests for Copilot credits, newest first, each with its strong ETag (@odata.etag) for a decision.
graph_list_copilot_funding_usage_records
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_list_copilot_group_usage_records
Free · Read-only
List Copilot credit consumption per security group for one completed UTC day.
graph_list_copilot_service_usage_records
Free · Read-only
List Copilot credit consumption per governed service for one completed UTC day.
graph_list_copilot_spending_alert_recipients
Free · Read-only
List the users who receive a Copilot spending policy's alerts.
graph_list_copilot_spending_policies
Free · Read-only
List the Copilot spending policies that cap credit consumption.
graph_list_copilot_spending_policy_groups
Free · Read-only
List the groups a selected-groups Copilot spending policy covers.
graph_list_copilot_spending_policy_services
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_list_copilot_user_service_balances
Free · Read-only
List one user's per-service Copilot balance rows: why the user can or cannot use each governed service.
graph_list_copilot_user_usage_records
Free · Read-only
List Copilot credit consumption per user for one completed UTC day.
graph_list_copilot_user_usage_services
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_list_copilot_user_usage_sessions
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_remove_copilot_spending_alert_recipient
Pro · Destructive
Remove a user from a Copilot spending policy's alert recipients.
graph_remove_copilot_spending_policy_group
Pro · Destructive
Remove a group from a selected-groups Copilot spending policy.
graph_set_copilot_spending_alert_settings
Pro · Write
Create or change the notify-only alert configuration of a Copilot spending policy (alerts email the recipients; they never stop spending).
graph_update_copilot_spending_policy
Pro · Destructive
Change a Copilot spending policy's name, limits or billing methods.
graph_update_copilot_spending_policy_service
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

ToolWhat it does
graph_block_copilot_package
Pro · Destructive
Block a Copilot package for the whole organization.
graph_get_copilot_package
Free · Read-only
Get one Copilot catalog package with its details: availability, deployment, owner and elements.
graph_list_copilot_packages
Free · Read-only
List the agents and apps in the organization's Copilot catalog, or the ones users requested.
graph_reassign_copilot_package
Pro · Destructive
Make another user the owner of a Copilot package, for example when its owner leaves.
graph_unblock_copilot_package
Pro · Write
Unblock a Copilot package so the organization can use it again.
graph_update_copilot_package_access
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

ToolWhat it does
graph_report_copilot_usage_user_detail
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_report_copilot_user_count_summary
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_report_copilot_user_count_trend
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

ToolWhat it does
graph_add_service_principal_token_signing_certificate
Pro · Write
Create a self-signed SAML token signing certificate on an enterprise application.
graph_get_application_template
Free · Read-only
Get one Microsoft Entra application gallery template: its supported single sign-on and provisioning modes.
graph_instantiate_application_template
Pro · Write
Add an application from the Entra gallery to the directory: Microsoft creates the application and its service principal and answers both.
graph_list_application_templates
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_set_application_single_sign_on_urls
Pro · Destructive
Set the SAML identifier URIs, the reply (redirect) URLs and the sign-out URL of an application.
graph_set_service_principal_single_sign_on
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

ToolWhat it does
graph_create_synchronization_job
Pro · Write
Create a provisioning (synchronization) job on an enterprise application from one of its templates.
graph_get_synchronization_job
Free · Read-only
Get one provisioning (synchronization) job: its status, last run, quarantine and schedule.
graph_list_synchronization_jobs
Free · Read-only
List the provisioning (synchronization) jobs of an enterprise application with their status and schedule.
graph_list_synchronization_templates
Free · Read-only
List the provisioning (synchronization) templates of an enterprise application: the template ids a provisioning job is created from.
graph_set_synchronization_secrets
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_start_synchronization_job
Pro · Write
Start a provisioning (synchronization) job, or resume a paused one.

Raw Requests

ToolWhat it does
graph_raw_get
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_raw_request
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.