{
  "opencollection": "1.0.0",
  "info": {
    "name": "Microsoft Entra Microsoft Graph Identity Applications Groups API",
    "version": "v1.0"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "client_credentials",
      "accessTokenUrl": "https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token",
      "credentials": {
        "clientId": "{{clientId}}",
        "clientSecret": "{{clientSecret}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "Groups",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Microsoft Entra List Groups",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://graph.microsoft.com/v1.0/groups",
            "headers": [
              {
                "name": "ConsistencyLevel",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "$select",
                "value": "id,displayName,mail",
                "type": "query",
                "description": "Comma-separated list of properties to include in the response. If unspecified, a default set of properties is returned."
              },
              {
                "name": "$filter",
                "value": "startswith(displayName,'J')",
                "type": "query",
                "description": "OData filter expression to restrict the returned collection"
              },
              {
                "name": "$orderby",
                "value": "displayName asc",
                "type": "query",
                "description": "Comma-separated list of properties to sort results by"
              },
              {
                "name": "$top",
                "value": "",
                "type": "query",
                "description": "Maximum number of items to return in the response"
              },
              {
                "name": "$skip",
                "value": "",
                "type": "query",
                "description": "Number of items to skip in the result set"
              },
              {
                "name": "$count",
                "value": "",
                "type": "query",
                "description": "Include a count of the total number of items in the collection. Requires ConsistencyLevel header set to eventual."
              },
              {
                "name": "$search",
                "value": "\"displayName:John\"",
                "type": "query",
                "description": "Search string to filter results using tokenized search across displayName and description properties. Requires ConsistencyLevel header set to eventual."
              },
              {
                "name": "$expand",
                "value": "memberOf",
                "type": "query",
                "description": "Comma-separated list of relationships to expand and include"
              }
            ]
          },
          "docs": "List all groups in the directory including Microsoft 365 groups, security groups, mail-enabled security groups, and distribution groups. Returns a paged collection with OData query support."
        },
        {
          "info": {
            "name": "Microsoft Entra Create Group",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://graph.microsoft.com/v1.0/groups",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new group in the directory. You can create Microsoft 365 groups, security groups, or mail-enabled security groups. Specify the groupTypes, mailEnabled, and securityEnabled properties to determine the type of group."
        },
        {
          "info": {
            "name": "Microsoft Entra Get Group",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://graph.microsoft.com/v1.0/groups/:group-id",
            "params": [
              {
                "name": "group-id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the group (object ID)"
              },
              {
                "name": "$select",
                "value": "id,displayName,mail",
                "type": "query",
                "description": "Comma-separated list of properties to include in the response. If unspecified, a default set of properties is returned."
              },
              {
                "name": "$expand",
                "value": "memberOf",
                "type": "query",
                "description": "Comma-separated list of relationships to expand and include"
              }
            ]
          },
          "docs": "Get the properties and relationships of a group object. Returns the default set of properties unless $select is specified."
        },
        {
          "info": {
            "name": "Microsoft Entra Update Group",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://graph.microsoft.com/v1.0/groups/:group-id",
            "params": [
              {
                "name": "group-id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the group (object ID)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update the properties of a group object. Not all properties can be updated depending on the group type."
        },
        {
          "info": {
            "name": "Microsoft Entra Delete Group",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://graph.microsoft.com/v1.0/groups/:group-id",
            "params": [
              {
                "name": "group-id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the group (object ID)"
              }
            ]
          },
          "docs": "Delete a group. Deleting a Microsoft 365 group moves it to the deletedItems container where it can be restored within 30 days. Security groups are permanently deleted immediately."
        },
        {
          "info": {
            "name": "Microsoft Entra List Group Members",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://graph.microsoft.com/v1.0/groups/:group-id/members",
            "headers": [
              {
                "name": "ConsistencyLevel",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "group-id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the group (object ID)"
              },
              {
                "name": "$select",
                "value": "id,displayName,mail",
                "type": "query",
                "description": "Comma-separated list of properties to include in the response. If unspecified, a default set of properties is returned."
              },
              {
                "name": "$filter",
                "value": "startswith(displayName,'J')",
                "type": "query",
                "description": "OData filter expression to restrict the returned collection"
              },
              {
                "name": "$top",
                "value": "",
                "type": "query",
                "description": "Maximum number of items to return in the response"
              },
              {
                "name": "$count",
                "value": "",
                "type": "query",
                "description": "Include a count of the total number of items in the collection. Requires ConsistencyLevel header set to eventual."
              }
            ]
          },
          "docs": "Get the direct members of a group. A group can have users, devices, other groups, organizational contacts, and service principals as members."
        },
        {
          "info": {
            "name": "Microsoft Entra Add Group Member",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://graph.microsoft.com/v1.0/groups/:group-id/members/$ref",
            "params": [
              {
                "name": "group-id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the group (object ID)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Add a member to a Microsoft 365 group or a security group by posting a reference to the directory object to add."
        },
        {
          "info": {
            "name": "Microsoft Entra Remove Group Member",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://graph.microsoft.com/v1.0/groups/:group-id/members/:directoryObject-id/$ref",
            "params": [
              {
                "name": "group-id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the group (object ID)"
              },
              {
                "name": "directoryObject-id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the directory object to remove"
              }
            ]
          },
          "docs": "Remove a member from a group via the members navigation property. Specify the member to remove by its directory object id."
        }
      ]
    }
  ],
  "bundled": true
}