Microsoft Graph Identity and Access API

openapi: 3.1.0
info:
  title: Microsoft Graph Identity API
  description: >-
    The Microsoft Graph Identity API provides a unified programmability model
    for managing Azure Active Directory (Microsoft Entra ID) resources including
    users, groups, applications, and service principals. This specification
    covers the core identity and access management endpoints available through
    the Microsoft Graph v1.0 REST API.
  version: 1.0.0
  contact:
    name: Microsoft Graph Support
    url: https://developer.microsoft.com/en-us/graph
    email: [email protected]
  license:
    name: Microsoft API License
    url: https://learn.microsoft.com/en-us/legal/microsoft-apis/terms-of-use
  x-api-id: microsoft-graph-identity
  x-audience: external-public
servers:
- url: https://graph.microsoft.com/v1.0
  description: Microsoft Graph v1.0 production endpoint
- url: https://graph.microsoft.com/beta
  description: Microsoft Graph beta endpoint (preview features)
security:
- oauth2:
  - User.Read
  - User.ReadWrite.All
  - Directory.Read.All
  - Directory.ReadWrite.All
tags:
- name: Users
  description: >-
    Manage user accounts in Azure Active Directory. Users are the core
    identity objects representing people in an organization. Each user has
    a profile with attributes such as display name, email, job title, and
    authentication credentials.
  externalDocs:
    url: https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0
- name: Groups
  description: >-
    Manage groups in Azure Active Directory. Groups can be security groups,
    Microsoft 365 groups, or mail-enabled security groups. They provide
    shared access to resources for a collection of users and other
    directory objects.
  externalDocs:
    url: https://learn.microsoft.com/en-us/graph/api/resources/group?view=graph-rest-1.0
- name: Applications
  description: >-
    Manage application registrations in Azure Active Directory. An
    application object is the global representation of an application
    across all tenants, defining the app identity, access configuration,
    and capabilities.
  externalDocs:
    url: https://learn.microsoft.com/en-us/graph/api/resources/application?view=graph-rest-1.0
- name: Service Principals
  description: >-
    Manage service principals in Azure Active Directory. A service principal
    is the local representation of an application in a specific tenant.
    It defines what the application can do in the tenant, who can access it,
    and what resources it can access.
  externalDocs:
    url: https://learn.microsoft.com/en-us/graph/api/resources/serviceprincipal?view=graph-rest-1.0
paths:
  /users:
    get:
      operationId: listUsers
      summary: List Users
      description: >-
        Retrieve a list of user objects. By default, only a limited set of
        properties are returned. To return additional properties, use the
        $select OData query parameter. Returns up to 100 objects by default
        and up to 999 with $top.
      tags:
      - Users
      parameters:
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - $ref: '#/components/parameters/orderby'
      - $ref: '#/components/parameters/select'
      - $ref: '#/components/parameters/expand'
      - $ref: '#/components/parameters/consistencyLevel'
      responses:
        '200':
          description: A collection of user objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  '@odata.context':
                    type: string
                    description: OData context URL.
                  '@odata.nextLink':
                    type: string
                    format: uri
                    description: URL to retrieve the next page of results.
                  '@odata.count':
                    type: integer
                    description: Total count of matching resources.
                  value:
                    type: array
                    items:
                      $ref: '#/components/schemas/User'
              examples:
                Listusers200Example:
                  summary: Default listUsers 200 response
                  x-microcks-default: true
                  value:
                    '@odata.context': example_value
                    '@odata.nextLink': https://www.example.com
                    '@odata.count': 10
                    value:
                    - accountEnabled: true
                      assignedLicenses:
                      - {}
                      assignedPlans:
                      - {}
                      businessPhones:
                      - {}
                      city: example_value
                      companyName: example_value
                      country: example_value
                      createdDateTime: '2026-01-15T10:30:00Z'
                      department: example_value
                      displayName: example_value
                      employeeId: '500123'
                      employeeType: example_value
                      givenName: example_value
                      jobTitle: example_value
                      mail: example_value
                      mailNickname: example_value
                      mobilePhone: example_value
                      officeLocation: example_value
                      onPremisesDistinguishedName: example_value
                      onPremisesDomainName: example_value
                      onPremisesImmutableId: '500123'
                      onPremisesLastSyncDateTime: '2026-01-15T10:30:00Z'
                      onPremisesSyncEnabled: example_value
                      otherMails:
                      - {}
                      passwordPolicies: example_value
                      postalCode: example_value
                      preferredLanguage: example_value
                      proxyAddresses:
                      - {}
                      signInSessionsValidFromDateTime: '2026-01-15T10:30:00Z'
                      state: example_value
                      streetAddress: example_value
                      surname: example_value
                      usageLocation: example_value
                      userPrincipalName: example_value
                      userType: Member
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
      - oauth2:
        - User.Read.All
        - Directory.Read.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createUser
      summary: Create User
      description: >-
        Create a new user object. The request body must contain the required
        properties for the user including displayName, accountEnabled,
        mailNickname, passwordProfile, and userPrincipalName.
      tags:
      - Users
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserCreate'
            examples:
              CreateuserRequestExample:
                summary: Default createUser request
                x-microcks-default: true
                value:
                  accountEnabled: true
                  displayName: example_value
                  mailNickname: example_value
                  userPrincipalName: example_value
                  passwordProfile:
                    forceChangePasswordNextSignIn: true
                    forceChangePasswordNextSignInWithMfa: true
                    password: example_value
                  givenName: example_value
                  surname: example_value
                  jobTitle: example_value
                  department: example_value
                  usageLocation: example_value
                  city: example_value
                  country: example_value
                  mobilePhone: example_value
                  businessPhones:
                  - example_value
      responses:
        '201':
          description: The created user object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
              examples:
                Createuser201Example:
                  summary: Default createUser 201 response
                  x-microcks-default: true
                  value:
                    accountEnabled: true
                    assignedLicenses:
                    - disabledPlans: {}
                      skuId: '500123'
                    assignedPlans:
                    - assignedDateTime: '2026-01-15T10:30:00Z'
                      capabilityStatus: Enabled
                      service: example_value
                      servicePlanId: '500123'
                    businessPhones:
                    - example_value
                    city: example_value
                    companyName: example_value
                    country: example_value
                    createdDateTime: '2026-01-15T10:30:00Z'
                    department: example_value
                    displayName: example_value
                    employeeId: '500123'
                    employeeType: example_value
                    givenName: example_value
                    jobTitle: example_value
                    mail: example_value
                    mailNickname: example_value
                    mobilePhone: example_value
                    officeLocation: example_value
                    onPremisesDistinguishedName: example_value
                    onPremisesDomainName: example_value
                    onPremisesImmutableId: '500123'
                    onPremisesLastSyncDateTime: '2026-01-15T10:30:00Z'
                    onPremisesSyncEnabled: example_value
                    otherMails:
                    - example_value
                    passwordPolicies: example_value
                    postalCode: example_value
                    preferredLanguage: example_value
                    proxyAddresses:
                    - example_value
                    signInSessionsValidFromDateTime: '2026-01-15T10:30:00Z'
                    state: example_value
                    streetAddress: example_value
                    surname: example_value
                    usageLocation: example_value
                    userPrincipalName: example_value
                    userType: Member
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - oauth2:
        - User.ReadWrite.All
        - Directory.ReadWrite.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/user-post-users?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /users/{user-id}:
    get:
      operationId: getUser
      summary: Get User
      description: >-
        Retrieve the properties and relationships of a user object. Returns
        a default set of properties unless $select is used to specify
        additional properties.
      tags:
      - Users
      parameters:
      - $ref: '#/components/parameters/userId'
      - $ref: '#/components/parameters/select'
      - $ref: '#/components/parameters/expand'
      responses:
        '200':
          description: The requested user object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
              examples:
                Getuser200Example:
                  summary: Default getUser 200 response
                  x-microcks-default: true
                  value:
                    accountEnabled: true
                    assignedLicenses:
                    - disabledPlans: {}
                      skuId: '500123'
                    assignedPlans:
                    - assignedDateTime: '2026-01-15T10:30:00Z'
                      capabilityStatus: Enabled
                      service: example_value
                      servicePlanId: '500123'
                    businessPhones:
                    - example_value
                    city: example_value
                    companyName: example_value
                    country: example_value
                    createdDateTime: '2026-01-15T10:30:00Z'
                    department: example_value
                    displayName: example_value
                    employeeId: '500123'
                    employeeType: example_value
                    givenName: example_value
                    jobTitle: example_value
                    mail: example_value
                    mailNickname: example_value
                    mobilePhone: example_value
                    officeLocation: example_value
                    onPremisesDistinguishedName: example_value
                    onPremisesDomainName: example_value
                    onPremisesImmutableId: '500123'
                    onPremisesLastSyncDateTime: '2026-01-15T10:30:00Z'
                    onPremisesSyncEnabled: example_value
                    otherMails:
                    - example_value
                    passwordPolicies: example_value
                    postalCode: example_value
                    preferredLanguage: example_value
                    proxyAddresses:
                    - example_value
                    signInSessionsValidFromDateTime: '2026-01-15T10:30:00Z'
                    state: example_value
                    streetAddress: example_value
                    surname: example_value
                    usageLocation: example_value
                    userPrincipalName: example_value
                    userType: Member
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - oauth2:
        - User.Read
        - User.Read.All
        - Directory.Read.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/user-get?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    patch:
      operationId: updateUser
      summary: Update User
      description: >-
        Update the properties of a user object. Not all properties can be
        updated by member or guest users with their default permissions
        without administrator roles.
      tags:
      - Users
      parameters:
      - $ref: '#/components/parameters/userId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserUpdate'
            examples:
              UpdateuserRequestExample:
                summary: Default updateUser request
                x-microcks-default: true
                value:
                  accountEnabled: true
                  displayName: example_value
                  givenName: example_value
                  surname: example_value
                  jobTitle: example_value
                  department: example_value
                  mail: example_value
                  mobilePhone: example_value
                  businessPhones:
                  - example_value
                  city: example_value
                  state: example_value
                  country: example_value
                  postalCode: example_value
                  streetAddress: example_value
                  officeLocation: example_value
                  usageLocation: example_value
                  passwordProfile:
                    forceChangePasswordNextSignIn: true
                    forceChangePasswordNextSignInWithMfa: true
                    password: example_value
                  preferredLanguage: example_value
                  employeeId: '500123'
                  employeeType: example_value
                  companyName: example_value
      responses:
        '204':
          description: User updated successfully. No content returned.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - oauth2:
        - User.ReadWrite.All
        - Directory.ReadWrite.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/user-update?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteUser
      summary: Delete User
      description: >-
        Delete a user object. When deleted, user resources are moved to a
        temporary container and can be restored within 30 days. After that
        time, they are permanently deleted.
      tags:
      - Users
      parameters:
      - $ref: '#/components/parameters/userId'
      responses:
        '204':
          description: User deleted successfully. No content returned.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - oauth2:
        - User.ReadWrite.All
        - Directory.ReadWrite.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/user-delete?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /users/{user-id}/memberOf:
    get:
      operationId: listUserMemberOf
      summary: List User Group Memberships
      description: >-
        Get the groups, directory roles, and administrative units that the
        user is a direct member of.
      tags:
      - Users
      parameters:
      - $ref: '#/components/parameters/userId'
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/select'
      - $ref: '#/components/parameters/count'
      - $ref: '#/components/parameters/consistencyLevel'
      responses:
        '200':
          description: A collection of directory objects the user is a member of.
          content:
            application/json:
              schema:
                type: object
                properties:
                  '@odata.context':
                    type: string
                  value:
                    type: array
                    items:
                      $ref: '#/components/schemas/DirectoryObject'
              examples:
                Listusermemberof200Example:
                  summary: Default listUserMemberOf 200 response
                  x-microcks-default: true
                  value:
                    '@odata.context': example_value
                    value:
                    - '@odata.type': example_value
                      id: abc123
                      deletedDateTime: '2026-01-15T10:30:00Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
      - oauth2:
        - User.Read
        - Directory.Read.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/user-list-memberof?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /groups:
    get:
      operationId: listGroups
      summary: List Groups
      description: >-
        List all the groups in an organization, including Microsoft 365
        groups, security groups, and mail-enabled security groups. Returns
        up to 100 objects by default.
      tags:
      - Groups
      parameters:
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - $ref: '#/components/parameters/orderby'
      - $ref: '#/components/parameters/select'
      - $ref: '#/components/parameters/expand'
      - $ref: '#/components/parameters/consistencyLevel'
      responses:
        '200':
          description: A collection of group objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  '@odata.context':
                    type: string
                  '@odata.nextLink':
                    type: string
                    format: uri
                  '@odata.count':
                    type: integer
                  value:
                    type: array
                    items:
                      $ref: '#/components/schemas/Group'
              examples:
                Listgroups200Example:
                  summary: Default listGroups 200 response
                  x-microcks-default: true
                  value:
                    '@odata.context': example_value
                    '@odata.nextLink': https://www.example.com
                    '@odata.count': 10
                    value:
                    - classification: example_value
                      createdDateTime: '2026-01-15T10:30:00Z'
                      description: A sample description.
                      displayName: example_value
                      expirationDateTime: '2026-01-15T10:30:00Z'
                      groupTypes:
                      - {}
                      isAssignableToRole: example_value
                      mail: example_value
                      mailEnabled: true
                      mailNickname: example_value
                      membershipRule: example_value
                      membershipRuleProcessingState: example_value
                      onPremisesDomainName: example_value
                      onPremisesLastSyncDateTime: '2026-01-15T10:30:00Z'
                      onPremisesSyncEnabled: example_value
                      preferredLanguage: example_value
                      proxyAddresses:
                      - {}
                      renewedDateTime: '2026-01-15T10:30:00Z'
                      securityEnabled: true
                      securityIdentifier: example_value
                      visibility: Public
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - oauth2:
        - GroupMember.Read.All
        - Group.Read.All
        - Directory.Read.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/group-list?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createGroup
      summary: Create Group
      description: >-
        Create a new group. You can create a Microsoft 365 group, a security
        group, or a mail-enabled security group. The request body must
        include displayName, mailEnabled, mailNickname, and
        securityEnabled.
      tags:
      - Groups
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GroupCreate'
            examples:
              CreategroupRequestExample:
                summary: Default createGroup request
                x-microcks-default: true
                value:
                  displayName: example_value
                  description: A sample description.
                  groupTypes:
                  - example_value
                  mailEnabled: true
                  mailNickname: example_value
                  securityEnabled: true
                  visibility: Public
                  isAssignableToRole: true
                  '[email protected]':
                  - https://www.example.com
                  '[email protected]':
                  - https://www.example.com
      responses:
        '201':
          description: The created group object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Group'
              examples:
                Creategroup201Example:
                  summary: Default createGroup 201 response
                  x-microcks-default: true
                  value:
                    classification: example_value
                    createdDateTime: '2026-01-15T10:30:00Z'
                    description: A sample description.
                    displayName: example_value
                    expirationDateTime: '2026-01-15T10:30:00Z'
                    groupTypes:
                    - example_value
                    isAssignableToRole: example_value
                    mail: example_value
                    mailEnabled: true
                    mailNickname: example_value
                    membershipRule: example_value
                    membershipRuleProcessingState: example_value
                    onPremisesDomainName: example_value
                    onPremisesLastSyncDateTime: '2026-01-15T10:30:00Z'
                    onPremisesSyncEnabled: example_value
                    preferredLanguage: example_value
                    proxyAddresses:
                    - example_value
                    renewedDateTime: '2026-01-15T10:30:00Z'
                    securityEnabled: true
                    securityIdentifier: example_value
                    visibility: Public
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      security:
      - oauth2:
        - Group.ReadWrite.All
        - Directory.ReadWrite.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/group-post-groups?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /groups/{group-id}:
    get:
      operationId: getGroup
      summary: Get Group
      description: >-
        Get the properties and relationships of a group object. Returns a
        default set of properties unless $select is used.
      tags:
      - Groups
      parameters:
      - $ref: '#/components/parameters/groupId'
      - $ref: '#/components/parameters/select'
      - $ref: '#/components/parameters/expand'
      responses:
        '200':
          description: The requested group object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Group'
              examples:
                Getgroup200Example:
                  summary: Default getGroup 200 response
                  x-microcks-default: true
                  value:
                    classification: example_value
                    createdDateTime: '2026-01-15T10:30:00Z'
                    description: A sample description.
                    displayName: example_value
                    expirationDateTime: '2026-01-15T10:30:00Z'
                    groupTypes:
                    - example_value
                    isAssignableToRole: example_value
                    mail: example_value
                    mailEnabled: true
                    mailNickname: example_value
                    membershipRule: example_value
                    membershipRuleProcessingState: example_value
                    onPremisesDomainName: example_value
                    onPremisesLastSyncDateTime: '2026-01-15T10:30:00Z'
                    onPremisesSyncEnabled: example_value
                    preferredLanguage: example_value
                    proxyAddresses:
                    - example_value
                    renewedDateTime: '2026-01-15T10:30:00Z'
                    securityEnabled: true
                    securityIdentifier: example_value
                    visibility: Public
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
      - oauth2:
        - GroupMember.Read.All
        - Group.Read.All
        - Directory.Read.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/group-get?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    patch:
      operationId: updateGroup
      summary: Update Group
      description: >-
        Update the properties of a group object. Not all properties can be
        updated at the same time.
      tags:
      - Groups
      parameters:
      - $ref: '#/components/parameters/groupId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GroupUpdate'
            examples:
              UpdategroupRequestExample:
                summary: Default updateGroup request
                x-microcks-default: true
                value:
                  displayName: example_value
                  description: A sample description.
                  mailNickname: example_value
                  visibility: Public
                  membershipRule: example_value
                  membershipRuleProcessingState: 'On'
                  preferredLanguage: example_value
                  classification: example_value
      responses:
        '204':
          description: Group updated successfully. No content returned.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
      - oauth2:
        - Group.ReadWrite.All
        - Directory.ReadWrite.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/group-update?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      operationId: deleteGroup
      summary: Delete Group
      description: >-
        Delete a group. When a Microsoft 365 group is deleted, it is moved
        to a temporary container and can be restored within 30 days. Security
        groups are permanently deleted immediately.
      tags:
      - Groups
      parameters:
      - $ref: '#/components/parameters/groupId'
      responses:
        '204':
          description: Group deleted successfully. No content returned.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
      - oauth2:
        - Group.ReadWrite.All
        - Directory.ReadWrite.All
      externalDocs:
        url: https://learn.microsoft.com/en-us/graph/api/group-delete?view=graph-rest-1.0
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /groups/{group-id}/members:
    get:
      operationId: listGroupMembers
      summary: List Group Members
      description: >-
        Get a list of the group's direct members. A group can have users,
        organizational contacts, devices, service principals, and other
        groups as members.
      tags:
      - Groups
      parameters:
      - $ref: '#/components/parameters/groupId'
      - $ref: '#/components/parameters/top'
  

# --- truncated at 32 KB (118 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-active-directory/refs/heads/main/openapi/microsoft-graph-identity-api.yml