Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Groups.group.Actions API

The groups.group.Actions API from Microsoft Entra ID (formerly Azure AD) — 18 operation(s) for groups.group.actions.

GitHub OpenAPI
Business capability
Identity & Access Management BC-620.20

Operations 18

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /groups/{group-id}/microsoft.graph.addFavorite Add a group to my favorites · Invoke action addFavorite #
Ask an LLM
“How do I pin a Microsoft 365 group to my favorites so it shows up in Outlook and Teams?”
“Can I favorite a group on behalf of the signed-in user?”
Tell an agent
Add group {group} to my favorite groups.
Favorite the Microsoft 365 group {group} for me.
POST /groups/{group-id}/microsoft.graph.assignLicense Add or remove licenses on a group · Invoke action assignLicense #
Ask an LLM
“How do I give every member of a group a license using group-based licensing?”
“Can I remove a license from a group so its members lose it?”
Tell an agent
Assign licenses {addLicenses} to group {group}.
Remove licenses {removeLicenses} from group {group}.
POST /groups/{group-id}/microsoft.graph.checkGrantedPermissionsForApp Check app permissions granted on a group · Invoke action checkGrantedPermissionsForApp #
Ask an LLM
“Which resource-specific permissions have apps been granted on this group?”
“Can I audit what an app is allowed to do inside a particular group?”
Tell an agent
Check the permissions granted to apps on group {group}.
Audit app permission grants for group {group}.
POST /groups/{group-id}/microsoft.graph.checkMemberGroups Check a group's membership in listed groups · Invoke action checkMemberGroups #
Ask an LLM
“Is this group a member of any of the groups on my shortlist, including nested membership?”
“How many group IDs can I check membership against in a single call?”
Tell an agent
Check which of groups {groupIds} group {group} belongs to.
Tell me whether group {group} is transitively a member of {groupIds}.
POST /groups/{group-id}/microsoft.graph.checkMemberObjects Check a group's membership in listed objects · Invoke action checkMemberObjects #
Ask an LLM
“Can I test whether a group belongs to specific groups, administrative units or directory roles by ID?”
“Which of a list of directory object IDs does this group hold membership in?”
Tell an agent
Check which of the objects {ids} group {group} is a member of.
Verify group {group}'s membership against directory objects {ids}.
POST /groups/{group-id}/microsoft.graph.getMemberGroups List every group a group belongs to · Invoke action getMemberGroups #
Ask an LLM
“What are all the groups this group is nested inside, directly or transitively?”
“Can I restrict the parent-group lookup to security-enabled groups only?”
Tell an agent
Get all group IDs that group {group} is a member of.
List the parent groups of {group} with security-enabled only set to {securityEnabledOnly}.
POST /groups/{group-id}/microsoft.graph.getMemberObjects List groups, units and roles a group belongs to · Invoke action getMemberObjects #
Ask an LLM
“Which groups, administrative units and directory roles is this group a member of?”
“Does the member-objects lookup include administrative units as well as groups?”
Tell an agent
Get every group, administrative unit and directory role ID that group {group} belongs to.
List member objects of group {group}, security-enabled only {securityEnabledOnly}.
POST /groups/{group-id}/microsoft.graph.removeFavorite Remove a group from my favorites · Invoke action removeFavorite #
Ask an LLM
“How do I unpin a Microsoft 365 group from my favorites?”
“Can I take a group off the signed-in user's favorite list?”
Tell an agent
Remove group {group} from my favorite groups.
Unfavorite the Microsoft 365 group {group}.
POST /groups/{group-id}/microsoft.graph.renew Renew a group's expiration · Invoke action renew #
Ask an LLM
“How do I keep a group from expiring under our group lifecycle policy?”
“When I renew a group, how long does its expiration get extended?”
Tell an agent
Renew group {group} so it doesn't expire.
Extend the expiration date of group {group}.
POST /groups/{group-id}/microsoft.graph.resetUnseenCount Mark all group posts as seen · Invoke action resetUnseenCount #
Ask an LLM
“How do I clear the unread post count on a Microsoft 365 group for myself?”
“Can I reset the unseen count of a group's conversations?”
Tell an agent
Reset my unseen post count for group {group}.
Mark every post in group {group} as seen for me.
POST /groups/{group-id}/microsoft.graph.restore Restore a deleted group · Invoke action restore #
Ask an LLM
“Can I bring back a group that was accidentally deleted?”
“How do I recover a recently deleted group from deleted items?”
Tell an agent
Restore deleted group {group}.
Recover group {group} from deleted items.
POST /groups/{group-id}/microsoft.graph.retryServiceProvisioning Retry provisioning services for a group · Invoke action retryServiceProvisioning #
Ask an LLM
“What can I do when a group's service provisioning failed?”
“Is there a way to kick off group service provisioning again?”
Tell an agent
Retry service provisioning for group {group}.
Rerun the failed provisioning on group {group}.
POST /groups/{group-id}/microsoft.graph.subscribeByMail Subscribe to a group's email notifications · Invoke action subscribeByMail #
Ask an LLM
“How do I start getting emails about new posts, events and files in a Microsoft 365 group?”
“Can I follow a group in my inbox as the signed-in user?”
Tell an agent
Subscribe me to email notifications for group {group}.
Start sending me mail about new activity in group {group}.
POST /groups/{group-id}/microsoft.graph.unsubscribeByMail Unsubscribe from a group's email notifications · Invoke action unsubscribeByMail #
Ask an LLM
“How do I stop getting emails about a Microsoft 365 group's posts and events?”
“Can I unfollow a group in my inbox without leaving it?”
Tell an agent
Unsubscribe me from email notifications for group {group}.
Stop sending me mail about activity in group {group}.
POST /groups/{group-id}/microsoft.graph.validateProperties Validate a rename of an existing group · Invoke action validateProperties #
Ask an LLM
“Will renaming an existing Microsoft 365 group to a new display name break our naming policy?”
“Can I check a new mail nickname for a group I already have before updating it?”
Tell an agent
Check whether existing group {group} can be renamed to {displayName} under the naming policy.
Validate new mail nickname {mailNickname} for group {group} before I update it.
POST /groups/microsoft.graph.getAvailableExtensionProperties List registered directory extension properties · Invoke action getAvailableExtensionProperties #
Ask an LLM
“Which directory extension properties are registered in my tenant, including from multitenant apps?”
“Can I see only the extension properties that were synced from on-premises?”
Tell an agent
List all directory extension properties available in the tenant.
List extension properties with synced-from-on-premises set to {isSyncedFromOnPremises}.
POST /groups/microsoft.graph.getByIds Fetch directory objects by a list of IDs · Invoke action getByIds #
Ask an LLM
“How can I resolve a batch of object IDs into users, groups and other directory objects in one call?”
“Can I limit an ID lookup to certain object types like groups or devices?”
Tell an agent
Get the directory objects with IDs {ids}.
Resolve IDs {ids} restricted to types {types}.
POST /groups/microsoft.graph.validateProperties Check a new group's name against naming policy · Invoke action validateProperties #
Ask an LLM
“Before I create a Microsoft 365 group, will its display name pass our prefix, suffix and banned-word rules?”
“Is a mail nickname already taken or blocked for a group that doesn't exist yet?”
Tell an agent
Check whether a new group named {displayName} would comply with the naming policy before I create it.
Validate proposed mail nickname {mailNickname} for a group I'm about to create on behalf of user {user}.

Documentation

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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-groups-group-actions-api-openapi.yml

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml

Work with this as data

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

MCP server

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

https://apis.io/mcp

Tools for apis

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

Call it yourself

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

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

Get an API key

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

GitHub Google LinkedIn

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

OpenAPI Specification

azure-ad-groups-group-actions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Groups.group.Actions API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (746 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-groups-group-actions-api-openapi.yml