Microsoft Graph Groups.group API

The Groups.group API from Microsoft Graph — 4 operation(s) for groups.group.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/admin?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/agreementacceptance?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/agreement?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teamsapp?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/application?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/applicationtemplate?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/azure-ad-auditlog-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/authenticationmethodconfiguration?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/authenticationmethodspolicy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/certificatebasedauthconfiguration?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/chat?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/communications-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/complianceapioverview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/externalconnectors-externalconnection?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/contact?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/contract?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/copilot-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/datapolicyoperation?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/intune-apps-conceptual?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/intune-device-conceptual?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/device?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/directory?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/domaindnsrecord?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/domain?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/drive?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/education-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/employee-experience-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/externalconnectors-external?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/filter-query-parameter
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/excel?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/grouplifecyclepolicy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groupsetting?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/groupsettingtemplate?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/identitycontainer?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/informationprotection?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/invitation?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/users?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/oauth2permissiongrant?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/organization?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/resourcespecificpermissiongrant?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/place?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/planner-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/policy-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/print?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/privacy?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/report?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/rolemanagement?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/schemaextension?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/scopedrolemembership?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/search-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/security-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/serviceprincipal?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/shares?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/sharepoint?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/solutions-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/filestorage?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/subscribedsku?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/subscription?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/teamwork?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/tenantrelationship?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/auth/auth-concepts
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/workplace?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0
📖
Documentation
https://learn.microsoft.com/en-us/graph/api/resources/sitepage?view=graph-rest-1.0

Specifications

Other Resources

OpenAPI Specification

microsoft-graph-groups-group-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Microsoft Graph Admin Admin.admin Groups.group API
  description: 'Microsoft Graph API for managing administrative resources in Microsoft Entra ID.

    This API enables administrators to manage Microsoft Edge browser settings, Internet Explorer mode configurations,

    site lists, shared browser sites, Microsoft 365 Apps installation options, people insights, service announcements,

    SharePoint settings, Copilot administration, directory administrative units, and admin consent policies.'
  version: 1.0.0
  contact:
    name: Microsoft Graph API Support
    url: https://developer.microsoft.com/graph
servers:
- url: https://graph.microsoft.com/v1.0
  description: Microsoft Graph API v1.0 endpoint
tags:
- name: Groups.group
paths:
  /groups:
    description: Provides operations to manage the collection of group entities.
    get:
      tags:
      - Groups.group
      summary: Microsoft Graph List groups
      description: List all the groups available in an organization, excluding dynamic distribution groups. To retrieve dynamic distribution groups, use the Exchange admin center. This operation returns by default only a subset of the properties for each group. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation for the group and specify the properties in a $select OData query option. The hasMembersWithLicenseErrors and isArchived properties are an exception and are not returned in the $select query.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-list?view=graph-rest-1.0
      operationId: groups.group.ListGroup
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/top'
      - $ref: '#/components/parameters/skip'
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      - $ref: '#/components/parameters/count'
      - name: $orderby
        in: query
        description: Order items by property values
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          $ref: '#/components/responses/microsoft.graph.groupCollectionResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
        operationName: listMore
      x-ms-docs-operation-type: operation
    post:
      tags:
      - Groups.group
      summary: Microsoft Graph Create group
      description: 'Create a new group as specified in the request body. You can create the following types of groups: This operation returns by default only a subset of the properties for each group. These default properties are noted in the Properties section. To get properties that are not returned by default, do a GET operation and specify the properties in a $select OData query option.'
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-post-groups?view=graph-rest-1.0
      operationId: groups.group.CreateGroup
      requestBody:
        description: New entity
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.group'
        required: true
      responses:
        2XX:
          description: Created entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.group'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /groups/{group-id}:
    description: Provides operations to manage the collection of group entities.
    parameters:
    - name: group-id
      in: path
      description: The unique identifier of group
      required: true
      schema:
        type: string
      x-ms-docs-key-type: group
    get:
      tags:
      - Groups.group
      summary: Microsoft Graph Get group
      description: Get the properties and relationships of a group object. This operation returns by default only a subset of all the available properties, as noted in the Properties section. To get properties that aren't_ returned by default, specify them in a $select OData query option. The hasMembersWithLicenseErrors and isArchived properties are an exception and aren't returned in the $select query.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-get?view=graph-rest-1.0
      operationId: groups.group.GetGroup
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.group'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - Groups.group
      summary: Microsoft Graph Upsert group
      description: "Create a new group object if it doesn't exist, or update the properties of an existing group object.\r\nYou can create or update the following types of group: By default, this operation returns only a subset of the properties for each group. For a list of properties that are returned by default, see the Properties section of the group resource. To get properties that are not returned by default, do a GET operation and specify the properties in a $select OData query option."
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-upsert?view=graph-rest-1.0
      operationId: groups.group.UpdateGroup
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.group'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.group'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - Groups.group
      summary: Microsoft Graph Delete group
      description: Delete a group. When deleted, both Microsoft 365 and security groups are moved to a temporary container and can be restored within 30 days. After that time, they're permanently deleted. This doesn't apply to Distribution groups which are permanently deleted immediately. To learn more, see deletedItems.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-delete?view=graph-rest-1.0
      operationId: groups.group.DeleteGroup
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /groups(uniqueName='{uniqueName}'):
    description: Provides operations to manage the collection of group entities.
    parameters:
    - name: uniqueName
      in: path
      description: Alternate key of group
      required: true
      schema:
        type: string
        nullable: true
    get:
      tags:
      - Groups.group
      summary: Microsoft Graph Get group
      description: Get the properties and relationships of a group object. This operation returns by default only a subset of all the available properties, as noted in the Properties section. To get properties that aren't_ returned by default, specify them in a $select OData query option. The hasMembersWithLicenseErrors and isArchived properties are an exception and aren't returned in the $select query.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-get?view=graph-rest-1.0
      operationId: groups.group.GetGroupByUniqueName
      parameters:
      - name: $select
        in: query
        description: Select properties to be returned
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      - name: $expand
        in: query
        description: Expand related entities
        style: form
        explode: false
        schema:
          uniqueItems: true
          type: array
          items:
            type: string
      responses:
        2XX:
          description: Retrieved entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.group'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    patch:
      tags:
      - Groups.group
      summary: Microsoft Graph Upsert group
      description: "Create a new group object if it doesn't exist, or update the properties of an existing group object.\r\nYou can create or update the following types of group: By default, this operation returns only a subset of the properties for each group. For a list of properties that are returned by default, see the Properties section of the group resource. To get properties that are not returned by default, do a GET operation and specify the properties in a $select OData query option."
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-upsert?view=graph-rest-1.0
      operationId: groups.group.UpdateGroupByUniqueName
      requestBody:
        description: New property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.group'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.group'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
    delete:
      tags:
      - Groups.group
      summary: Microsoft Graph Delete group
      description: Delete a group. When deleted, both Microsoft 365 and security groups are moved to a temporary container and can be restored within 30 days. After that time, they're permanently deleted. This doesn't apply to Distribution groups which are permanently deleted immediately. To learn more, see deletedItems.
      externalDocs:
        description: Find more info here
        url: https://learn.microsoft.com/graph/api/group-delete?view=graph-rest-1.0
      operationId: groups.group.DeleteGroupByUniqueName
      parameters:
      - name: If-Match
        in: header
        description: ETag
        schema:
          type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      x-ms-docs-operation-type: operation
  /groups/$count:
    description: Provides operations to count the resources in the collection.
    get:
      tags:
      - Groups.group
      summary: Microsoft Graph Get the number of the resource
      operationId: groups.GetCount-044a
      parameters:
      - name: ConsistencyLevel
        in: header
        description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries'
        schema:
          type: string
        examples:
          example-1:
            description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.
            value: eventual
      - $ref: '#/components/parameters/search'
      - $ref: '#/components/parameters/filter'
      responses:
        2XX:
          $ref: '#/components/responses/ODataCountResponse'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
components:
  schemas:
    microsoft.graph.richLongRunningOperation:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.longRunningOperation'
      - title: richLongRunningOperation
        required:
        - '@odata.type'
        type: object
        properties:
          error:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.publicError'
            - type: object
              nullable: true
            description: Error that caused the operation to fail.
          percentageComplete:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: A value between 0 and 100 that indicates the progress of the operation.
            format: int32
            nullable: true
          resourceId:
            type: string
            description: The unique identifier for the result.
            nullable: true
          type:
            type: string
            description: The type of the operation.
            nullable: true
          '@odata.type':
            type: string
        description: The status of a long-running operation.
      x-ms-discriminator-value: '#microsoft.graph.richLongRunningOperation'
    microsoft.graph.workbookWorksheet:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: workbookWorksheet
        required:
        - '@odata.type'
        type: object
        properties:
          name:
            type: string
            description: The display name of the worksheet.
            nullable: true
          position:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: The zero-based position of the worksheet within the workbook.
            format: int32
          visibility:
            type: string
            description: 'The visibility of the worksheet. The possible values are: Visible, Hidden, VeryHidden.'
          charts:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.workbookChart'
            description: The list of charts that are part of the worksheet. Read-only.
            x-ms-navigationProperty: true
          names:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.workbookNamedItem'
            description: The list of names that are associated with the worksheet. Read-only.
            x-ms-navigationProperty: true
          pivotTables:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.workbookPivotTable'
            description: The list of piot tables that are part of the worksheet.
            x-ms-navigationProperty: true
          protection:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.workbookWorksheetProtection'
            - type: object
              nullable: true
            description: The sheet protection object for a worksheet. Read-only.
            x-ms-navigationProperty: true
          tables:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.workbookTable'
            description: The list of tables that are part of the worksheet. Read-only.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.workbookWorksheet'
    microsoft.graph.teamworkHostedContent:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: teamworkHostedContent
        required:
        - '@odata.type'
        type: object
        properties:
          contentBytes:
            type: string
            description: Write only. Bytes for the hosted content (such as images).
            format: base64url
            nullable: true
          contentType:
            type: string
            description: Write only. Content type. such as image/png, image/jpg.
            nullable: true
          '@odata.type':
            type: string
        discriminator:
          propertyName: '@odata.type'
          mapping:
            '#microsoft.graph.chatMessageHostedContent': '#/components/schemas/microsoft.graph.chatMessageHostedContent'
    microsoft.graph.profilePhoto:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: profilePhoto
        required:
        - '@odata.type'
        type: object
        properties:
          height:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: The height of the photo. Read-only.
            format: int32
            nullable: true
          width:
            maximum: 2147483647
            minimum: -2147483648
            type: number
            description: The width of the photo. Read-only.
            format: int32
            nullable: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.profilePhoto'
    microsoft.graph.phoneType:
      title: phoneType
      enum:
      - home
      - business
      - mobile
      - other
      - assistant
      - homeFax
      - businessFax
      - otherFax
      - pager
      - radio
      type: string
    microsoft.graph.objectIdentity:
      title: objectIdentity
      required:
      - '@odata.type'
      type: object
      properties:
        issuer:
          type: string
          description: Specifies the issuer of the identity, for example facebook.com. 512 character limit. For local accounts (where signInType isn't federated), this property is the local default domain name for the tenant, for example contoso.com.  For guests from other Microsoft Entra organizations, this is the domain of the federated organization, for example contoso.com. For more information about filtering behavior for this property, see Filtering on the identities property of a user.
          nullable: true
        issuerAssignedId:
          type: string
          description: 'Specifies the unique identifier assigned to the user by the issuer. 64 character limit. The combination of issuer and issuerAssignedId must be unique within the organization. Represents the sign-in name for the user, when signInType is set to emailAddress or userName (also known as local accounts).When signInType is set to: emailAddress (or a custom string that starts with emailAddress like emailAddress1), issuerAssignedId must be a valid email addressuserName, issuerAssignedId must begin with an alphabetical character or number, and can only contain alphanumeric characters and the following symbols: - or _  For more information about filtering behavior for this property, see Filtering on the identities property of a user.'
          nullable: true
        signInType:
          type: string
          description: Specifies the user sign-in types in your directory, such as emailAddress, userName, federated, or userPrincipalName. federated represents a unique identifier for a user from an issuer that can be in any format chosen by the issuer. Setting or updating a userPrincipalName identity updates the value of the userPrincipalName property on the user object. The validations performed on the userPrincipalName property on the user object, for example, verified domains and acceptable characters, are performed when setting or updating a userPrincipalName identity. Extra validation is enforced on issuerAssignedId when the sign-in type is set to emailAddress or userName. This property can also be set to any custom string.  For more information about filtering behavior for this property, see Filtering on the identities property of a user.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.managedAppRegistration:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: managedAppRegistration
        required:
        - '@odata.type'
        type: object
        properties:
          appIdentifier:
            anyOf:
            - $ref: '#/components/schemas/microsoft.graph.mobileAppIdentifier'
            - type: object
              nullable: true
            description: The app package Identifier
          applicationVersion:
            type: string
            description: App version
            nullable: true
          createdDateTime:
            pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
            type: string
            description: Date and time of creation
            format: date-time
          deviceName:
            type: string
            description: Host device name
            nullable: true
          deviceTag:
            type: string
            description: App management SDK generated tag, which helps relate apps hosted on the same device. Not guaranteed to relate apps in all conditions.
            nullable: true
          deviceType:
            type: string
            description: Host device type
            nullable: true
          flaggedReasons:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.managedAppFlaggedReason'
            description: Zero or more reasons an app registration is flagged. E.g. app running on rooted device
          lastSyncDateTime:
            pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
            type: string
            description: Date and time of last the app synced with management service.
            format: date-time
          managementSdkVersion:
            type: string
            description: App management SDK version
            nullable: true
          platformVersion:
            type: string
            description: Operating System version
            nullable: true
          userId:
            type: string
            description: The user Id to who this app registration belongs.
            nullable: true
          version:
            type: string
            description: Version of the entity.
            nullable: true
          appliedPolicies:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.managedAppPolicy'
            description: Zero or more policys already applied on the registered app when it last synchronized with managment service.
            x-ms-navigationProperty: true
          intendedPolicies:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.managedAppPolicy'
            description: Zero or more policies admin intended for the app as of now.
            x-ms-navigationProperty: true
          operations:
            type: array
            items:
              $ref: '#/components/schemas/microsoft.graph.managedAppOperation'
            description: Zero or more long running operations triggered on the app registration.
            x-ms-navigationProperty: true
          '@odata.type':
            type: string
        description: The ManagedAppEntity is the base entity type for all other entity types under app management workflow.
        discriminator:
          propertyName: '@odata.type'
          mapping:
            '#microsoft.graph.androidManagedAppRegistration': '#/components/schemas/microsoft.graph.androidManagedAppRegistration'
            '#microsoft.graph.iosManagedAppRegistration': '#/components/schemas/microsoft.graph.iosManagedAppRegistration'
    microsoft.graph.termColumn:
      title: termColumn
      required:
      - '@odata.type'
      type: object
      properties:
        allowMultipleValues:
          type: boolean
          description: Specifies whether the column allows more than one value.
          nullable: true
        showFullyQualifiedName:
          type: boolean
          description: Specifies whether to display the entire term path or only the term label.
          nullable: true
        parentTerm:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.termStore.term'
          - type: object
            nullable: true
          x-ms-navigationProperty: true
        termSet:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.termStore.set'
          - type: object
            nullable: true
          x-ms-navigationProperty: true
        '@odata.type':
          type: string
    microsoft.graph.shared:
      title: shared
      required:
      - '@odata.type'
      type: object
      properties:
        owner:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.identitySet'
          - type: object
            nullable: true
          description: The identity of the owner of the shared item. Read-only.
        scope:
          type: string
          description: 'Indicates the scope of how the item is shared. The possible values are: anonymous, organization, or users. Read-only.'
          nullable: true
        sharedBy:
          anyOf:
          - $ref: '#/components/schemas/microsoft.graph.identitySet'
          - type: object
            nullable: true
          description: The identity of the user who shared the item. Read-only.
        sharedDateTime:
          pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
          type: string
          description: The UTC date and time when the item was shared. Read-only.
          format: date-time
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.settingValue:
      title: settingValue
      required:
      - '@odata.type'
      type: object
      properties:
        name:
          type: string
          description: Name of the setting (as defined by the groupSettingTemplate).
          nullable: true
        value:
          type: string
          description: Value of the setting.
          nullable: true
        '@odata.type':
          type: string
    microsoft.graph.managementAgentType:
      title: managementAgentType
      enum:
      - eas
      - mdm
      - easMdm
      - intuneClient
      - easIntuneClient
      - configurationManagerClient
      - configurationManagerClientMdm
      - configurationManagerClientMdmEas
      - unknown
      - jamf
      - googleCloudDevicePolicyController
      - microsoft365ManagedMdm
      - msSense
      type: string
      x-ms-enum:
        name: managementAgentType
        modelAsString: false
        values:
        - value: eas
          description: The device is managed by Exchange server.
          name: eas
        - value: mdm
          description: The device is managed by Intune MDM.
          name: mdm
        - value: easMdm
          description: The device is managed by both Exchange server and Intune MDM.
          name: easMdm
        - value: intuneClient
          description: Intune client managed.
          name: intuneClient
        - value: easIntuneClient
          description: The device is EAS and Intune client dual managed.
          name: easIntuneClient
        - value: configurationManagerClient
          description: The device is managed by Configuration Manager.
          name: configurationManagerClient
        - value: configurationManagerClientMdm
          description: The device is managed by Configuration Manager and MDM.
          name: configurationManagerClientMdm
        - value: configurationManagerClientMdmEas
          description: The device is managed by Configuration Manager, MDM and Eas.
          name: configurationManagerClientMdmEas
        - value: unknown
          description: Unknown management agent type.
          name: unknown
        - value: jamf
          description: The device attributes are fetched from Jamf.
          name: jamf
        - value: googleCloudDevicePolicyController
          description: The device is managed by Google's CloudDPC.
          name: googleCloudDevicePolicyController
        - value: microsoft365ManagedMdm
          description: This device is managed by Microsoft 365 through Intune.
          name: microsoft365ManagedMdm
    microsoft.graph.workbookCommentReply:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: workbookCommentReply
        required:
        - '@odata.type'
        type: object
        properties:
          content:
            type: string
            description: The content of the reply.
            nullable: true
          contentType:
            type: string
            description: The content type for the reply.
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.workbookCommentReply'
    microsoft.graph.singleValueLegacyExtendedProperty:
      allOf:
      - $ref: '#/components/schemas/microsoft.graph.entity'
      - title: singleValueLegacyExtendedProperty
        required:
        - '@odata.type'
        type: object
        properties:
          value:
            type: string
            description: A property value.
            nullable: true
          '@odata.type':
            type: string
      x-ms-discriminator-value: '#microsoft.graph.singleValueLegacyExtendedProperty'
    microsoft.graph.onPremisesExtensionAttributes:
      title: onPremisesExtensionAttributes
      required:
      - '@odata.type'
      type: object
      properties:
        extensionAttribute1:
          type: string
          description: First customizable extension attribute.
          nullable: true
        extensionAttribute10:
          type: string
          description: Tenth customizable extension attribute.
          nullable: true
        extensionAttribute11:
          type: string
          description: Eleventh customizable extension attribute.
          nullable: true
        extensionAttribute12:
          type: string
          description: Twelfth customizable extension attribute.
          nullable: true
        extensionAttribute13:
          type: string
          description: Thirteenth customizable extension attribute.
          nullable: true
        extensionAttribute14:
          type: string
          description: Fourteenth customizable extension attribute.
          nullable: true
        extensionAttribute15:
          type: string
          description: Fifteenth customizable extension attribute.
          nullable: true
        extensionAttribute2:
          type: string
          description: Second customizable extension attribute.
          nullab

# --- truncated at 32 KB (1006 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/microsoft-graph-groups-group-api-openapi.yml