diff --git a/.gitignore b/.gitignore index 92436a90ac7..990f0a3da9b 100644 --- a/.gitignore +++ b/.gitignore @@ -367,4 +367,8 @@ coverage.xml examplesreport/ # Code sign summary -CodeSignSummary-*.md \ No newline at end of file +CodeSignSummary-*.md + +# PowerShell module manifests (generated at build time) +*.psd1 +!src/Authentication/Authentication/Microsoft.Graph.Authentication.psd1 \ No newline at end of file diff --git a/openApiDocs/beta/DeviceManagement.Enrollment.yml b/openApiDocs/beta/DeviceManagement.Enrollment.yml index 7a7f131ab90..75427bef7ac 100644 --- a/openApiDocs/beta/DeviceManagement.Enrollment.yml +++ b/openApiDocs/beta/DeviceManagement.Enrollment.yml @@ -6892,7 +6892,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Get unifiedRoleAssignmentMultiple - description: "Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." + description: "Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." operationId: roleManagement.cloudPC_ListRoleAssignment parameters: - $ref: '#/components/parameters/top' @@ -6949,7 +6949,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Create unifiedRoleAssignmentMultiple - description: "Create a new unifiedRoleAssignmentMultiple object for an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." + description: "Create a new unifiedRoleAssignmentMultiple object for an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/rbacapplicationmultiple-post-roleassignments?view=graph-rest-beta @@ -6982,7 +6982,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Get unifiedRoleAssignmentMultiple - description: "Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." + description: "Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-get?view=graph-rest-beta @@ -7036,7 +7036,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Update unifiedRoleAssignmentMultiple - description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune) In contrast, unifiedRoleAssignment does not support update." + description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune) In contrast, unifiedRoleAssignment does not support update." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-update?view=graph-rest-beta @@ -7077,7 +7077,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Delete unifiedRoleAssignmentMultiple - description: "Delete a unifiedRoleAssignmentMultiple object of an RBAC provider. This is applicable for a RBAC application that supports multiple principals and scopes. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC)" + description: "Delete a unifiedRoleAssignmentMultiple object of an RBAC provider. This is applicable for a RBAC application that supports multiple principals and scopes. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC)" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-delete?view=graph-rest-beta @@ -7770,7 +7770,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: List roleDefinitions - description: "Get a list of unifiedRoleDefinition objects for an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR)\n- directory (Microsoft Entra ID) \n- entitlement management (Microsoft Entra ID)\n- Exchange Online" + description: "Get a list of unifiedRoleDefinition objects for an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR)\r\n- directory (Microsoft Entra ID) \r\n- entitlement management (Microsoft Entra ID)\r\n- Exchange Online" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/rbacapplication-list-roledefinitions?view=graph-rest-beta @@ -7830,7 +7830,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Create roleDefinitions - description: "Create a new unifiedRoleDefinition object for an RBAC provider. This feature requires a Microsoft Entra ID P1 or P2 license. The following RBAC providers are currently supported:\n- Cloud PC\n- device management (Intune)\n- Defender (Microsoft Defender XDR)\n- directory (Microsoft Entra ID)" + description: "Create a new unifiedRoleDefinition object for an RBAC provider. This feature requires a Microsoft Entra ID P1 or P2 license. The following RBAC providers are currently supported:\r\n- Cloud PC\r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR)\r\n- directory (Microsoft Entra ID)" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/rbacapplication-post-roledefinitions?view=graph-rest-beta @@ -7863,7 +7863,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Get unifiedRoleDefinition - description: "Get the properties and relationships of a unifiedRoleDefinition object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC)\n- directory (Microsoft Entra directory roles)\n- entitlement management (Microsoft Entra entitlement management)\n- Exchange Online (Except China operated by 21Vianet)" + description: "Get the properties and relationships of a unifiedRoleDefinition object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC)\r\n- directory (Microsoft Entra directory roles)\r\n- entitlement management (Microsoft Entra entitlement management)\r\n- Exchange Online (Except China operated by 21Vianet)" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroledefinition-get?view=graph-rest-beta @@ -7917,7 +7917,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Update unifiedRoleDefinition - description: "Update the properties of a unifiedRoleDefinition object for an RBAC provider. You cannot update built-in roles. This feature requires a Microsoft Entra ID P1 or P2 license. The following RBAC providers are currently supported:\n- Cloud PC\n- device management (Intune)\n- directory (Microsoft Entra ID) " + description: "Update the properties of a unifiedRoleDefinition object for an RBAC provider. You cannot update built-in roles. This feature requires a Microsoft Entra ID P1 or P2 license. The following RBAC providers are currently supported:\r\n- Cloud PC\r\n- device management (Intune)\r\n- directory (Microsoft Entra ID) " externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroledefinition-update?view=graph-rest-beta @@ -7958,7 +7958,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Delete unifiedRoleDefinition - description: "Delete a unifiedRoleDefinition object for an RBAC provider. You cannot delete built-in roles. This feature requires a Microsoft Entra ID P1 or P2 license. The following RBAC providers are currently supported:\n- Cloud PC\n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC)\n- directory (Microsoft Entra ID) " + description: "Delete a unifiedRoleDefinition object for an RBAC provider. You cannot delete built-in roles. This feature requires a Microsoft Entra ID P1 or P2 license. The following RBAC providers are currently supported:\r\n- Cloud PC\r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC)\r\n- directory (Microsoft Entra ID) " externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroledefinition-delete?view=graph-rest-beta @@ -9358,11 +9358,11 @@ paths: get: tags: - roleManagement.rbacApplicationMultiple - summary: Get unifiedRoleAssignmentMultiple - description: "Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." + summary: List unifiedRoleAssignmentMultiple + description: "Get a list of unifiedRoleAssignmentMultiple objects for an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." externalDocs: description: Find more info here - url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-get?view=graph-rest-beta + url: https://learn.microsoft.com/graph/api/rbacapplicationmultiple-list-roleassignments?view=graph-rest-beta operationId: roleManagement.deviceManagement_ListRoleAssignment parameters: - $ref: '#/components/parameters/top' @@ -9419,7 +9419,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Create unifiedRoleAssignmentMultiple - description: "Create a new unifiedRoleAssignmentMultiple object for an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." + description: "Create a new unifiedRoleAssignmentMultiple object for an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/rbacapplicationmultiple-post-roleassignments?view=graph-rest-beta @@ -9452,7 +9452,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Get unifiedRoleAssignmentMultiple - description: "Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." + description: "Get the properties and relationships of a unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC) For other Microsoft 365 applications (like Microsoft Entra ID), use unifiedRoleAssignment." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-get?view=graph-rest-beta @@ -9506,7 +9506,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Update unifiedRoleAssignmentMultiple - description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune) In contrast, unifiedRoleAssignment does not support update." + description: "Update an existing unifiedRoleAssignmentMultiple object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune) In contrast, unifiedRoleAssignment does not support update." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-update?view=graph-rest-beta @@ -9547,7 +9547,7 @@ paths: tags: - roleManagement.rbacApplicationMultiple summary: Delete unifiedRoleAssignmentMultiple - description: "Delete a unifiedRoleAssignmentMultiple object of an RBAC provider. This is applicable for a RBAC application that supports multiple principals and scopes. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC)" + description: "Delete a unifiedRoleAssignmentMultiple object of an RBAC provider. This is applicable for a RBAC application that supports multiple principals and scopes. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC)" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroleassignmentmultiple-delete?view=graph-rest-beta @@ -12055,7 +12055,7 @@ paths: tags: - roleManagement.unifiedRbacApplication summary: List unifiedRoleAssignments - description: "Get a list of unifiedRoleAssignment objects for the provider. The following RBAC providers are currently supported:\n- directory (Microsoft Entra ID)\n- entitlement management (Microsoft Entra entitlement management)\n- Exchange Online" + description: "Get a list of unifiedRoleAssignment objects for the provider. The following RBAC providers are currently supported:\r\n- directory (Microsoft Entra ID)\r\n- entitlement management (Microsoft Entra entitlement management)\r\n- Exchange Online" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/rbacapplication-list-roleassignments?view=graph-rest-beta @@ -12573,7 +12573,7 @@ paths: tags: - roleManagement.unifiedRbacApplication summary: List roleDefinitions - description: "Get a list of unifiedRoleDefinition objects for an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR)\n- directory (Microsoft Entra ID) \n- entitlement management (Microsoft Entra ID)\n- Exchange Online" + description: "Get a list of unifiedRoleDefinition objects for an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR)\r\n- directory (Microsoft Entra ID) \r\n- entitlement management (Microsoft Entra ID)\r\n- Exchange Online" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/rbacapplication-list-roledefinitions?view=graph-rest-beta @@ -12662,7 +12662,7 @@ paths: tags: - roleManagement.unifiedRbacApplication summary: Get unifiedRoleDefinition - description: "Get the properties and relationships of a unifiedRoleDefinition object of an RBAC provider. The following RBAC providers are currently supported:\n- Cloud PC \n- device management (Intune)\n- Defender (Microsoft Defender XDR Unified RBAC)\n- directory (Microsoft Entra directory roles)\n- entitlement management (Microsoft Entra entitlement management)\n- Exchange Online (Except China operated by 21Vianet)" + description: "Get the properties and relationships of a unifiedRoleDefinition object of an RBAC provider. The following RBAC providers are currently supported:\r\n- Cloud PC \r\n- device management (Intune)\r\n- Defender (Microsoft Defender XDR Unified RBAC)\r\n- directory (Microsoft Entra directory roles)\r\n- entitlement management (Microsoft Entra entitlement management)\r\n- Exchange Online (Except China operated by 21Vianet)" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/unifiedroledefinition-get?view=graph-rest-beta @@ -14396,6 +14396,8 @@ components: chooseYourLockScreenDisabled: type: boolean description: Indicates if iCloud Documents and Desktop screen is disabled + depProfileAdminAccountPasswordRotationSetting: + $ref: '#/components/schemas/microsoft.graph.depProfileAdminAccountPasswordRotationSetting' dontAutoPopulatePrimaryAccountInfo: type: boolean description: Indicates whether Setup Assistant will auto populate the primary account information @@ -15908,6 +15910,21 @@ components: nullable: true additionalProperties: type: object + microsoft.graph.depProfileAdminAccountPasswordRotationSetting: + title: depProfileAdminAccountPasswordRotationSetting + type: object + properties: + autoRotationPeriodInDays: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Indicates the number of days between 1-180 since the last rotation after which to rotate the local admin password. + format: int32 + depProfileDelayAutoRotationSetting: + $ref: '#/components/schemas/microsoft.graph.depProfileDelayAutoRotationSetting' + additionalProperties: + type: object + description: Settings for local admin account password automatic rotation. microsoft.graph.discoverySource: title: discoverySource enum: @@ -16931,6 +16948,22 @@ components: - value: exclude description: 'Indicates out-filter, rule matching will not offer the payload to devices.' name: exclude + microsoft.graph.depProfileDelayAutoRotationSetting: + title: depProfileDelayAutoRotationSetting + type: object + properties: + onRetrievalAutoRotatePasswordEnabled: + type: boolean + description: Indicates whether the admin account password should be rotated when retrieved by IT Admin through Intune. + onRetrievalDelayAutoRotatePasswordInHours: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Indicates how long in hours (between 1 and 24 hours) after password retrieval through Graph should automatic rotation be initiated for the admin account password. + format: int32 + additionalProperties: + type: object + description: Settings related to auto rotation of local admin account password after password retrieval through Graph. These are optional settings microsoft.graph.importedWindowsAutopilotDeviceIdentityImportStatus: title: importedWindowsAutopilotDeviceIdentityImportStatus enum: @@ -17467,11 +17500,11 @@ components: properties: displayName: type: string - description: The display name of the identity. This property is read-only. + description: 'The display name of the identity. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don''t show up as changed when using delta.' nullable: true id: type: string - description: The identifier of the identity. This property is read-only. + description: 'Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that''s subject to review.' nullable: true additionalProperties: type: object diff --git a/openApiDocs/beta/WindowsUpdates.yml b/openApiDocs/beta/WindowsUpdates.yml index bee937d2e6d..c218096e0e0 100644 --- a/openApiDocs/beta/WindowsUpdates.yml +++ b/openApiDocs/beta/WindowsUpdates.yml @@ -4707,13 +4707,16 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' - /admin/windows/updates/products: + /admin/windows/updates/policies: get: tags: - admin.adminWindows - summary: Get products from admin - description: A collection of Windows products. - operationId: admin.window.update_ListProduct + summary: List policies + description: 'Get a list of the policy objects and their properties. You can use this method with the following child object type: qualityUpdatePolicy.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-adminwindowsupdates-list-policies?view=graph-rest-beta + operationId: admin.window.update_ListPolicy parameters: - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' @@ -4752,7 +4755,7 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.productCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.policyCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -4762,14 +4765,18 @@ paths: post: tags: - admin.adminWindows - summary: Create new navigation property to products for admin - operationId: admin.window.update_CreateProduct + summary: Create policy + description: 'Create a new Windows update policy object. You can use this method with the following child object type: qualityUpdatePolicy.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-adminwindowsupdates-post-policies?view=graph-rest-beta + operationId: admin.window.update_CreatePolicy requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policy' required: true responses: 2XX: @@ -4777,26 +4784,29 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policy' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}': + '/admin/windows/updates/policies/{policy-id}': get: tags: - admin.adminWindows - summary: Get products from admin - description: A collection of Windows products. - operationId: admin.window.update_GetProduct + summary: Get policy + description: 'Read the properties and relationships of a policy object. You can use this method with the following child object type: qualityUpdatePolicy.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-get?view=graph-rest-beta + operationId: admin.window.update_GetPolicy parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy - name: $select in: query description: Select properties to be returned @@ -4823,30 +4833,34 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policy' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property products in admin - operationId: admin.window.update_UpdateProduct + summary: Update policy + description: 'Update the properties of a policy object. You can use this method with the following child object type: qualityUpdatePolicy.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-update?view=graph-rest-beta + operationId: admin.window.update_UpdatePolicy parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policy' required: true responses: 2XX: @@ -4854,24 +4868,28 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policy' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property products for admin - operationId: admin.window.update_DeleteProduct + summary: Delete policy + description: 'Delete a Windows update policy object. You can use this method with the following child object type: qualityUpdatePolicy.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-delete?view=graph-rest-beta + operationId: admin.window.update_DeletePolicy parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy - name: If-Match in: header description: ETag @@ -4884,22 +4902,25 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/editions': + '/admin/windows/updates/policies/{policy-id}/applicableContent': get: tags: - admin.adminWindows - summary: Get editions from admin - description: Represents an edition of a particular Windows product. - operationId: admin.window.update.product_ListEdition + summary: List applicableContent + description: 'List applicable update content to offer to Microsoft Entra groups, Windows Autopatch groups, or both.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-list-applicablecontent?view=graph-rest-beta + operationId: admin.window.update.policy_ListApplicableContent parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -4937,7 +4958,7 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.editionCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.applicableContentCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -4947,23 +4968,23 @@ paths: post: tags: - admin.adminWindows - summary: Create new navigation property to editions for admin - operationId: admin.window.update.product_CreateEdition + summary: Create new navigation property to applicableContent for admin + operationId: admin.window.update.policy_CreateApplicableContent parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' required: true responses: 2XX: @@ -4971,34 +4992,34 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/editions/{edition-id}': + '/admin/windows/updates/policies/{policy-id}/applicableContent/{applicableContent-catalogEntryId}': get: tags: - admin.adminWindows - summary: Get editions from admin - description: Represents an edition of a particular Windows product. - operationId: admin.window.update.product_GetEdition + summary: Get applicableContent from admin + description: Represents content applicable for offering to the related collection of devices. + operationId: admin.window.update.policy_GetApplicableContent parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: edition-id + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of edition + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: edition + x-ms-docs-key-type: applicableContent - name: $select in: query description: Select properties to be returned @@ -5025,38 +5046,38 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property editions in admin - operationId: admin.window.update.product_UpdateEdition + summary: Update the navigation property applicableContent in admin + operationId: admin.window.update.policy_UpdateApplicableContent parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: edition-id + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of edition + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: edition + x-ms-docs-key-type: applicableContent requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' required: true responses: 2XX: @@ -5064,32 +5085,32 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property editions for admin - operationId: admin.window.update.product_DeleteEdition + summary: Delete navigation property applicableContent for admin + operationId: admin.window.update.policy_DeleteApplicableContent parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: edition-id + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of edition + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: edition + x-ms-docs-key-type: applicableContent - name: If-Match in: header description: ETag @@ -5102,44 +5123,84 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/editions/$count': + '/admin/windows/updates/policies/{policy-id}/applicableContent/{applicableContent-catalogEntryId}/catalogEntry': get: tags: - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.product.edition_GetCount + summary: Get catalogEntry from admin + description: Catalog entry for the update or content. + operationId: admin.window.update.policy.applicableContent_GetCatalogEntry parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId + in: path + description: The unique identifier of applicableContent + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContent + - 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/ODataCountResponse' + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' default: $ref: '#/components/responses/error' - '/admin/windows/updates/products/{product-id}/knownIssues': + x-ms-docs-operation-type: operation + '/admin/windows/updates/policies/{policy-id}/applicableContent/{applicableContent-catalogEntryId}/matchedDevices': get: tags: - admin.adminWindows - summary: Get knownIssues from admin - description: Represents a known issue related to a Windows product. - operationId: admin.window.update.product_ListKnownIssue + summary: Get matchedDevices from admin + description: Collection of devices and recommendations for applicable catalog content. + operationId: admin.window.update.policy.applicableContent_ListMatchedDevice parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId + in: path + description: The unique identifier of applicableContent + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContent - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -5177,7 +5238,7 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.knownIssueCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.applicableContentDeviceMatchCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -5187,23 +5248,31 @@ paths: post: tags: - admin.adminWindows - summary: Create new navigation property to knownIssues for admin - operationId: admin.window.update.product_CreateKnownIssue + summary: Create new navigation property to matchedDevices for admin + operationId: admin.window.update.policy.applicableContent_CreateMatchedDevice parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId + in: path + description: The unique identifier of applicableContent + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContent requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' required: true responses: 2XX: @@ -5211,34 +5280,42 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/knownIssues/{knownIssue-id}': + '/admin/windows/updates/policies/{policy-id}/applicableContent/{applicableContent-catalogEntryId}/matchedDevices/{applicableContentDeviceMatch-deviceId}': get: tags: - admin.adminWindows - summary: Get knownIssues from admin - description: Represents a known issue related to a Windows product. - operationId: admin.window.update.product_GetKnownIssue + summary: Get matchedDevices from admin + description: Collection of devices and recommendations for applicable catalog content. + operationId: admin.window.update.policy.applicableContent_GetMatchedDevice parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: knownIssue-id + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of knownIssue + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: applicableContent + - name: applicableContentDeviceMatch-deviceId + in: path + description: The unique identifier of applicableContentDeviceMatch + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContentDeviceMatch - name: $select in: query description: Select properties to be returned @@ -5265,38 +5342,46 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property knownIssues in admin - operationId: admin.window.update.product_UpdateKnownIssue + summary: Update the navigation property matchedDevices in admin + operationId: admin.window.update.policy.applicableContent_UpdateMatchedDevice parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: knownIssue-id + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of knownIssue + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: applicableContent + - name: applicableContentDeviceMatch-deviceId + in: path + description: The unique identifier of applicableContentDeviceMatch + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContentDeviceMatch requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' required: true responses: 2XX: @@ -5304,32 +5389,40 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property knownIssues for admin - operationId: admin.window.update.product_DeleteKnownIssue + summary: Delete navigation property matchedDevices for admin + operationId: admin.window.update.policy.applicableContent_DeleteMatchedDevice parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: knownIssue-id + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of knownIssue + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: applicableContent + - name: applicableContentDeviceMatch-deviceId + in: path + description: The unique identifier of applicableContentDeviceMatch + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContentDeviceMatch - name: If-Match in: header description: ETag @@ -5342,30 +5435,92 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/knownIssues/{knownIssue-id}/originatingKnowledgeBaseArticle': + '/admin/windows/updates/policies/{policy-id}/applicableContent/{applicableContent-catalogEntryId}/matchedDevices/$count': get: tags: - admin.adminWindows - summary: Get originatingKnowledgeBaseArticle from admin - description: Knowledge base article associated with the release when the known issue was first reported. - operationId: admin.window.update.product.knownIssue_GetOriginatingKnowledgeBaseArticle + summary: Get the number of the resource + operationId: admin.window.update.policy.applicableContent.matchedDevice_GetCount parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: knownIssue-id + x-ms-docs-key-type: policy + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of knownIssue + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: applicableContent + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/admin/windows/updates/policies/{policy-id}/applicableContent/$count': + get: + tags: + - admin.adminWindows + summary: Get the number of the resource + operationId: admin.window.update.policy.applicableContent_GetCount + parameters: + - name: policy-id + in: path + description: The unique identifier of policy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: policy + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/admin/windows/updates/policies/{policy-id}/approvals': + get: + tags: + - admin.adminWindows + summary: List approvals + description: Get a list of the policyApproval objects and their properties. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-list-approvals?view=graph-rest-beta + operationId: admin.window.update.policy_ListApproval + parameters: + - name: policy-id + in: path + description: The unique identifier of policy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: policy + - $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 @@ -5388,111 +5543,75 @@ paths: type: string responses: 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.policyApprovalCollectionResponse' default: $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore x-ms-docs-operation-type: operation - patch: + post: tags: - admin.adminWindows - summary: Update the navigation property originatingKnowledgeBaseArticle in admin - operationId: admin.window.update.product.knownIssue_UpdateOriginatingKnowledgeBaseArticle + summary: Create policyApproval + description: Create a new policyApproval object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-post-approvals?view=graph-rest-beta + operationId: admin.window.update.policy_CreateApproval parameters: - - name: product-id - in: path - description: The unique identifier of product - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: product - - name: knownIssue-id + - name: policy-id in: path - description: The unique identifier of knownIssue + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: policy requestBody: - description: New navigation property values + description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policyApproval' required: true responses: 2XX: - description: Success + description: Created navigation property. content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: - tags: - - admin.adminWindows - summary: Delete navigation property originatingKnowledgeBaseArticle for admin - operationId: admin.window.update.product.knownIssue_DeleteOriginatingKnowledgeBaseArticle - parameters: - - name: product-id - in: path - description: The unique identifier of product - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: product - - name: knownIssue-id - in: path - description: The unique identifier of knownIssue - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: knownIssue - - name: If-Match - in: header - description: ETag - style: simple - schema: - type: string - responses: - 2XX: - description: Success + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policyApproval' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/knownIssues/{knownIssue-id}/resolvingKnowledgeBaseArticle': + '/admin/windows/updates/policies/{policy-id}/approvals/{policyApproval-id}': get: tags: - admin.adminWindows - summary: Get resolvingKnowledgeBaseArticle from admin - description: Knowledge base article associated with the release when the known issue was resolved or mitigated. - operationId: admin.window.update.product.knownIssue_GetResolvingKnowledgeBaseArticle + summary: Get policyApproval + description: Read the properties and relationships of a policyApproval object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policyapproval-get?view=graph-rest-beta + operationId: admin.window.update.policy_GetApproval parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: knownIssue-id + x-ms-docs-key-type: policy + - name: policyApproval-id in: path - description: The unique identifier of knownIssue + description: The unique identifier of policyApproval required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: policyApproval - name: $select in: query description: Select properties to be returned @@ -5519,38 +5638,42 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policyApproval' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property resolvingKnowledgeBaseArticle in admin - operationId: admin.window.update.product.knownIssue_UpdateResolvingKnowledgeBaseArticle + summary: Update policyApproval + description: Update the properties of a policyApproval object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policyapproval-update?view=graph-rest-beta + operationId: admin.window.update.policy_UpdateApproval parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: knownIssue-id + x-ms-docs-key-type: policy + - name: policyApproval-id in: path - description: The unique identifier of knownIssue + description: The unique identifier of policyApproval required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: policyApproval requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policyApproval' required: true responses: 2XX: @@ -5558,32 +5681,36 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policyApproval' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property resolvingKnowledgeBaseArticle for admin - operationId: admin.window.update.product.knownIssue_DeleteResolvingKnowledgeBaseArticle + summary: Delete policyApproval + description: Delete a policyApproval object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policyapproval-delete?view=graph-rest-beta + operationId: admin.window.update.policy_DeleteApproval parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: knownIssue-id + x-ms-docs-key-type: policy + - name: policyApproval-id in: path - description: The unique identifier of knownIssue + description: The unique identifier of policyApproval required: true style: simple schema: type: string - x-ms-docs-key-type: knownIssue + x-ms-docs-key-type: policyApproval - name: If-Match in: header description: ETag @@ -5596,21 +5723,75 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/knownIssues/$count': + '/admin/windows/updates/policies/{policy-id}/approvals/{policyApproval-id}/catalogEntry': + get: + tags: + - admin.adminWindows + summary: Get catalogEntry from admin + description: The content that you can approve for deployment. Read-only. + operationId: admin.window.update.policy.approval_GetCatalogEntry + parameters: + - name: policy-id + in: path + description: The unique identifier of policy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: policy + - name: policyApproval-id + in: path + description: The unique identifier of policyApproval + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: policyApproval + - 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 navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/policies/{policy-id}/approvals/$count': get: tags: - admin.adminWindows summary: Get the number of the resource - operationId: admin.window.update.product.knownIssue_GetCount + operationId: admin.window.update.policy.approval_GetCount parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -5618,52 +5799,33 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' - '/admin/windows/updates/products/{product-id}/microsoft.graph.windowsUpdates.getKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive=@includeAllActive)': + '/admin/windows/updates/policies/{policy-id}/rings': get: tags: - admin.adminWindows - summary: Invoke function getKnownIssuesByTimeRange - description: Get known issues related to a particular product based on a specified timeframe in the past. + summary: List rings + description: 'Get a list of the ring objects and their properties. You can use this method with the following child object type: qualityUpdateRing.' externalDocs: description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-product-getknownissuesbytimerange?view=graph-rest-beta - operationId: admin.window.update.product_getKnownIssuesGraphBPreTimeRange + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-list-rings?view=graph-rest-beta + operationId: admin.window.update.policy_ListRing parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: daysInPast - in: path - description: 'Usage: daysInPast={daysInPast}' - required: true - style: simple - schema: - maximum: 2147483647 - minimum: -2147483648 - type: number - format: int32 - - name: includeAllActive - in: query - description: 'Usage: includeAllActive=@includeAllActive' - style: form - explode: false - schema: - type: boolean - default: false - nullable: true + x-ms-docs-key-type: policy - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' - $ref: '#/components/parameters/count' - - name: $select + - name: $orderby in: query - description: Select properties to be returned + description: Order items by property values style: form explode: false schema: @@ -5671,9 +5833,9 @@ paths: type: array items: type: string - - name: $orderby + - name: $select in: query - description: Order items by property values + description: Select properties to be returned style: form explode: false schema: @@ -5693,82 +5855,7 @@ paths: type: string responses: 2XX: - description: Success - content: - application/json: - schema: - title: Collection of knownIssue - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' - '@odata.nextLink': - type: string - nullable: true - additionalProperties: - type: object - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - '/admin/windows/updates/products/{product-id}/revisions': - get: - tags: - - admin.adminWindows - summary: Get revisions from admin - description: Represents a product revision. - operationId: admin.window.update.product_ListRevision - parameters: - - name: product-id - in: path - description: The unique identifier of product - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: product - - $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.windowsUpdates.productRevisionCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.ringCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -5778,23 +5865,27 @@ paths: post: tags: - admin.adminWindows - summary: Create new navigation property to revisions for admin - operationId: admin.window.update.product_CreateRevision + summary: Create ring + description: 'Create a new ring object. You can use this method with the following child object type: qualityUpdateRing.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-policy-post-rings?view=graph-rest-beta + operationId: admin.window.update.policy_CreateRing parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product + x-ms-docs-key-type: policy requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.ring' required: true responses: 2XX: @@ -5802,34 +5893,37 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.ring' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/revisions/{productRevision-id}': + '/admin/windows/updates/policies/{policy-id}/rings/{ring-id}': get: tags: - admin.adminWindows - summary: Get revisions from admin - description: Represents a product revision. - operationId: admin.window.update.product_GetRevision + summary: Get ring + description: 'Read the properties and relationships of ring object. You can use this method with the following child object type: qualityUpdateRing.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-ring-get?view=graph-rest-beta + operationId: admin.window.update.policy_GetRing parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: productRevision-id + x-ms-docs-key-type: policy + - name: ring-id in: path - description: The unique identifier of productRevision + description: The unique identifier of ring required: true style: simple schema: type: string - x-ms-docs-key-type: productRevision + x-ms-docs-key-type: ring - name: $select in: query description: Select properties to be returned @@ -5856,38 +5950,42 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.ring' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property revisions in admin - operationId: admin.window.update.product_UpdateRevision + summary: Update ring + description: 'Update the properties of a ring object. You can use this method with the following child object type: qualityUpdateRing.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-ring-update?view=graph-rest-beta + operationId: admin.window.update.policy_UpdateRing parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: productRevision-id + x-ms-docs-key-type: policy + - name: ring-id in: path - description: The unique identifier of productRevision + description: The unique identifier of ring required: true style: simple schema: type: string - x-ms-docs-key-type: productRevision + x-ms-docs-key-type: ring requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.ring' required: true responses: 2XX: @@ -5895,32 +5993,36 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.ring' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property revisions for admin - operationId: admin.window.update.product_DeleteRevision + summary: Delete ring + description: 'Delete a ring object. You can use this method with the following child object type: qualityUpdateRing.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-ring-delete?view=graph-rest-beta + operationId: admin.window.update.policy_DeleteRing parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: productRevision-id + x-ms-docs-key-type: policy + - name: ring-id in: path - description: The unique identifier of productRevision + description: The unique identifier of ring required: true style: simple schema: type: string - x-ms-docs-key-type: productRevision + x-ms-docs-key-type: ring - name: If-Match in: header description: ETag @@ -5933,29 +6035,132 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/revisions/{productRevision-id}/catalogEntry': + '/admin/windows/updates/policies/{policy-id}/rings/$count': get: tags: - admin.adminWindows - summary: Get catalogEntry from admin - operationId: admin.window.update.product.revision_GetCatalogEntry + summary: Get the number of the resource + operationId: admin.window.update.policy.ring_GetCount parameters: - - name: product-id + - name: policy-id in: path - description: The unique identifier of product + description: The unique identifier of policy required: true style: simple schema: type: string - x-ms-docs-key-type: product - - name: productRevision-id + x-ms-docs-key-type: policy + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /admin/windows/updates/policies/$count: + get: + tags: + - admin.adminWindows + summary: Get the number of the resource + operationId: admin.window.update.policy_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /admin/windows/updates/products: + get: + tags: + - admin.adminWindows + summary: Get products from admin + description: A collection of Windows products. + operationId: admin.window.update_ListProduct + parameters: + - $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.windowsUpdates.productCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - admin.adminWindows + summary: Create new navigation property to products for admin + operationId: admin.window.update_CreateProduct + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/products/{product-id}': + get: + tags: + - admin.adminWindows + summary: Get products from admin + description: A collection of Windows products. + operationId: admin.window.update_GetProduct + parameters: + - name: product-id in: path - description: The unique identifier of productRevision + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: productRevision + x-ms-docs-key-type: product - name: $select in: query description: Select properties to be returned @@ -5982,15 +6187,15 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property catalogEntry in admin - operationId: admin.window.update.product.revision_UpdateCatalogEntry + summary: Update the navigation property products in admin + operationId: admin.window.update_UpdateProduct parameters: - name: product-id in: path @@ -6000,20 +6205,12 @@ paths: schema: type: string x-ms-docs-key-type: product - - name: productRevision-id - in: path - description: The unique identifier of productRevision - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: productRevision requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' required: true responses: 2XX: @@ -6021,15 +6218,15 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property catalogEntry for admin - operationId: admin.window.update.product.revision_DeleteCatalogEntry + summary: Delete navigation property products for admin + operationId: admin.window.update_DeleteProduct parameters: - name: product-id in: path @@ -6039,14 +6236,6 @@ paths: schema: type: string x-ms-docs-key-type: product - - name: productRevision-id - in: path - description: The unique identifier of productRevision - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: productRevision - name: If-Match in: header description: ETag @@ -6059,13 +6248,13 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/revisions/{productRevision-id}/knowledgeBaseArticle': + '/admin/windows/updates/products/{product-id}/editions': get: tags: - admin.adminWindows - summary: Get knowledgeBaseArticle from admin - description: The knowledge base article associated with the product revision. - operationId: admin.window.update.product.revision_GetKnowledgeBaseArticle + summary: Get editions from admin + description: Represents an edition of a particular Windows product. + operationId: admin.window.update.product_ListEdition parameters: - name: product-id in: path @@ -6075,14 +6264,105 @@ paths: schema: type: string x-ms-docs-key-type: product - - name: productRevision-id + - $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.windowsUpdates.editionCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - admin.adminWindows + summary: Create new navigation property to editions for admin + operationId: admin.window.update.product_CreateEdition + parameters: + - name: product-id in: path - description: The unique identifier of productRevision + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: productRevision + x-ms-docs-key-type: product + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/products/{product-id}/editions/{edition-id}': + get: + tags: + - admin.adminWindows + summary: Get editions from admin + description: Represents an edition of a particular Windows product. + operationId: admin.window.update.product_GetEdition + parameters: + - name: product-id + in: path + description: The unique identifier of product + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: product + - name: edition-id + in: path + description: The unique identifier of edition + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: edition - name: $select in: query description: Select properties to be returned @@ -6109,15 +6389,15 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property knowledgeBaseArticle in admin - operationId: admin.window.update.product.revision_UpdateKnowledgeBaseArticle + summary: Update the navigation property editions in admin + operationId: admin.window.update.product_UpdateEdition parameters: - name: product-id in: path @@ -6127,20 +6407,20 @@ paths: schema: type: string x-ms-docs-key-type: product - - name: productRevision-id + - name: edition-id in: path - description: The unique identifier of productRevision + description: The unique identifier of edition required: true style: simple schema: type: string - x-ms-docs-key-type: productRevision + x-ms-docs-key-type: edition requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' required: true responses: 2XX: @@ -6148,15 +6428,15 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property knowledgeBaseArticle for admin - operationId: admin.window.update.product.revision_DeleteKnowledgeBaseArticle + summary: Delete navigation property editions for admin + operationId: admin.window.update.product_DeleteEdition parameters: - name: product-id in: path @@ -6166,14 +6446,14 @@ paths: schema: type: string x-ms-docs-key-type: product - - name: productRevision-id + - name: edition-id in: path - description: The unique identifier of productRevision + description: The unique identifier of edition required: true style: simple schema: type: string - x-ms-docs-key-type: productRevision + x-ms-docs-key-type: edition - name: If-Match in: header description: ETag @@ -6186,12 +6466,12 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/products/{product-id}/revisions/$count': + '/admin/windows/updates/products/{product-id}/editions/$count': get: tags: - admin.adminWindows summary: Get the number of the resource - operationId: admin.window.update.product.revision_GetCount + operationId: admin.window.update.product.edition_GetCount parameters: - name: product-id in: path @@ -6208,43 +6488,30 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' - /admin/windows/updates/products/$count: - get: - tags: - - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.product_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/admin/windows/updates/products/microsoft.graph.windowsUpdates.findByCatalogId(catalogID=''{catalogID}'')': + '/admin/windows/updates/products/{product-id}/knownIssues': get: tags: - admin.adminWindows - summary: Invoke function findByCatalogId - operationId: admin.window.update.product_findGraphBPreCatalogId + summary: Get knownIssues from admin + description: Represents a known issue related to a Windows product. + operationId: admin.window.update.product_ListKnownIssue parameters: - - name: catalogID + - name: product-id in: path - description: 'Usage: catalogID=''{catalogID}''' + description: The unique identifier of product required: true style: simple schema: type: string - nullable: true + x-ms-docs-key-type: product - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' - $ref: '#/components/parameters/count' - - name: $select + - name: $orderby in: query - description: Select properties to be returned + description: Order items by property values style: form explode: false schema: @@ -6252,9 +6519,9 @@ paths: type: array items: type: string - - name: $orderby + - name: $select in: query - description: Order items by property values + description: Select properties to be returned style: form explode: false schema: @@ -6274,50 +6541,68 @@ paths: type: string responses: 2XX: - description: Success - content: - application/json: - schema: - title: Collection of product - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' - '@odata.nextLink': - type: string - nullable: true - additionalProperties: - type: object + $ref: '#/components/responses/microsoft.graph.windowsUpdates.knownIssueCollectionResponse' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: function x-ms-pageable: nextLinkName: '@odata.nextLink' operationName: listMore - '/admin/windows/updates/products/microsoft.graph.windowsUpdates.findByKbNumber(kbNumber={kbNumber})': + x-ms-docs-operation-type: operation + post: + tags: + - admin.adminWindows + summary: Create new navigation property to knownIssues for admin + operationId: admin.window.update.product_CreateKnownIssue + parameters: + - name: product-id + in: path + description: The unique identifier of product + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: product + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/products/{product-id}/knownIssues/{knownIssue-id}': get: tags: - admin.adminWindows - summary: Invoke function findByKbNumber - operationId: admin.window.update.product_findGraphBPreKbNumber + summary: Get knownIssues from admin + description: Represents a known issue related to a Windows product. + operationId: admin.window.update.product_GetKnownIssue parameters: - - name: kbNumber + - name: product-id in: path - description: 'Usage: kbNumber={kbNumber}' + description: The unique identifier of product required: true style: simple schema: - maximum: 2147483647 - minimum: -2147483648 - type: number - format: int32 - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' + type: string + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: knownIssue - name: $select in: query description: Select properties to be returned @@ -6328,19 +6613,9 @@ paths: type: array items: type: string - - name: $orderby + - name: $expand in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities + description: Expand related entities style: form explode: false schema: @@ -6350,128 +6625,111 @@ paths: type: string responses: 2XX: - description: Success + description: Retrieved navigation property content: application/json: schema: - title: Collection of product - type: object - properties: - value: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' - '@odata.nextLink': - type: string - nullable: true - additionalProperties: - type: object + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: function - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - /admin/windows/updates/resourceConnections: - get: + x-ms-docs-operation-type: operation + patch: tags: - admin.adminWindows - summary: List resourceConnections - description: Get a list of the resourceConnection objects and their properties. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/adminwindowsupdates-list-resourceconnections?view=graph-rest-beta - operationId: admin.window.update_ListResourceConnection + summary: Update the navigation property knownIssues in admin + operationId: admin.window.update.product_UpdateKnownIssue parameters: - - $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 + - name: product-id + in: path + description: The unique identifier of product + required: true + style: simple schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false + type: string + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.resourceConnectionCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - admin.adminWindows - summary: Create operationalInsightsConnection - description: Create a new operationalInsightsConnection object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection?view=graph-rest-beta - operationId: admin.window.update_CreateResourceConnection + type: string + x-ms-docs-key-type: knownIssue requestBody: - description: New navigation property + description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' required: true responses: 2XX: - description: Created navigation property. + description: Success content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/resourceConnections/{resourceConnection-id}': + delete: + tags: + - admin.adminWindows + summary: Delete navigation property knownIssues for admin + operationId: admin.window.update.product_DeleteKnownIssue + parameters: + - name: product-id + in: path + description: The unique identifier of product + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: knownIssue + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/products/{product-id}/knownIssues/{knownIssue-id}/originatingKnowledgeBaseArticle': get: tags: - admin.adminWindows - summary: Get operationalInsightsConnection - description: Read the properties and relationships of an operationalInsightsConnection object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-operationalinsightsconnection-get?view=graph-rest-beta - operationId: admin.window.update_GetResourceConnection + summary: Get originatingKnowledgeBaseArticle from admin + description: Knowledge base article associated with the release when the known issue was first reported. + operationId: admin.window.update.product.knownIssue_GetOriginatingKnowledgeBaseArticle parameters: - - name: resourceConnection-id + - name: product-id in: path - description: The unique identifier of resourceConnection + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: resourceConnection + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: knownIssue - name: $select in: query description: Select properties to be returned @@ -6498,30 +6756,38 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property resourceConnections in admin - operationId: admin.window.update_UpdateResourceConnection + summary: Update the navigation property originatingKnowledgeBaseArticle in admin + operationId: admin.window.update.product.knownIssue_UpdateOriginatingKnowledgeBaseArticle parameters: - - name: resourceConnection-id + - name: product-id in: path - description: The unique identifier of resourceConnection + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: resourceConnection + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: knownIssue requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' required: true responses: 2XX: @@ -6529,28 +6795,32 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete operationalInsightsConnection - description: Delete an operationalInsightsConnection object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-operationalinsightsconnection-delete?view=graph-rest-beta - operationId: admin.window.update_DeleteResourceConnection + summary: Delete navigation property originatingKnowledgeBaseArticle for admin + operationId: admin.window.update.product.knownIssue_DeleteOriginatingKnowledgeBaseArticle parameters: - - name: resourceConnection-id + - name: product-id in: path - description: The unique identifier of resourceConnection + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: resourceConnection + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: knownIssue - name: If-Match in: header description: ETag @@ -6563,120 +6833,30 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - /admin/windows/updates/resourceConnections/$count: - get: - tags: - - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.resourceConnection_GetCount - parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /admin/windows/updates/updatableAssets: + '/admin/windows/updates/products/{product-id}/knownIssues/{knownIssue-id}/resolvingKnowledgeBaseArticle': get: tags: - admin.adminWindows - summary: List updatableAssets - description: 'Get a list of updatableAsset objects and their properties. Listing updatable assets returns updatableAsset resources of the following derived types: azureADDevice and updatableAssetGroup. Use list azureADDevice resources or list updatableAssetGroup resources to filter and get resources of only one of the derived types.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/adminwindowsupdates-list-updatableassets?view=graph-rest-beta - operationId: admin.window.update_ListUpdatableAsset + summary: Get resolvingKnowledgeBaseArticle from admin + description: Knowledge base article associated with the release when the known issue was resolved or mitigated. + operationId: admin.window.update.product.knownIssue_GetResolvingKnowledgeBaseArticle parameters: - - $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 + - name: product-id + in: path + description: The unique identifier of product + required: true + style: simple schema: - uniqueItems: true - type: array - items: - type: string - responses: - 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.updatableAssetCollectionResponse' - default: - $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore - x-ms-docs-operation-type: operation - post: - tags: - - admin.adminWindows - summary: Create updatableAssetGroup - description: Create a new updatableAssetGroup object. The updatableAssetGroup resource inherits from updatableAsset. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/adminwindowsupdates-post-updatableassets-updatableassetgroup?view=graph-rest-beta - operationId: admin.window.update_CreateUpdatableAsset - requestBody: - description: New navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - required: true - responses: - 2XX: - description: Created navigation property. - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/admin/windows/updates/updatableAssets/{updatableAsset-id}': - get: - tags: - - admin.adminWindows - summary: Get azureADDevice - description: Read the properties of an azureADDevice object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-azureaddevice-get?view=graph-rest-beta - operationId: admin.window.update_GetUpdatableAsset - parameters: - - name: updatableAsset-id + type: string + x-ms-docs-key-type: product + - name: knownIssue-id in: path - description: The unique identifier of updatableAsset + description: The unique identifier of knownIssue required: true style: simple schema: type: string - x-ms-docs-key-type: updatableAsset + x-ms-docs-key-type: knownIssue - name: $select in: query description: Select properties to be returned @@ -6703,30 +6883,38 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property updatableAssets in admin - operationId: admin.window.update_UpdateUpdatableAsset + summary: Update the navigation property resolvingKnowledgeBaseArticle in admin + operationId: admin.window.update.product.knownIssue_UpdateResolvingKnowledgeBaseArticle parameters: - - name: updatableAsset-id + - name: product-id in: path - description: The unique identifier of updatableAsset + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatableAsset + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: knownIssue requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' required: true responses: 2XX: @@ -6734,28 +6922,32 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete azureADDevice - description: 'Delete an azureADDevice object. When a Microsoft Entra device is deleted, it is unregistered and automatically unenrolled from management for all update categories, as well as removed from every deploymentAudience and updatableAssetGroup.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-azureaddevice-delete?view=graph-rest-beta - operationId: admin.window.update_DeleteUpdatableAsset + summary: Delete navigation property resolvingKnowledgeBaseArticle for admin + operationId: admin.window.update.product.knownIssue_DeleteResolvingKnowledgeBaseArticle parameters: - - name: updatableAsset-id + - name: product-id in: path - description: The unique identifier of updatableAsset + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatableAsset + x-ms-docs-key-type: product + - name: knownIssue-id + in: path + description: The unique identifier of knownIssue + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: knownIssue - name: If-Match in: header description: ETag @@ -6768,319 +6960,141 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembers': - post: + '/admin/windows/updates/products/{product-id}/knownIssues/$count': + get: tags: - admin.adminWindows - summary: Invoke action addMembers - description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta - operationId: admin.window.update.updatableAsset_addMember + summary: Get the number of the resource + operationId: admin.window.update.product.knownIssue_GetCount parameters: - - name: updatableAsset-id + - name: product-id in: path - description: The unique identifier of updatableAsset + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatableAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object - required: true + x-ms-docs-key-type: product + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' responses: 2XX: - description: Success + $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembersById': - post: + '/admin/windows/updates/products/{product-id}/microsoft.graph.windowsUpdates.getKnownIssuesByTimeRange(daysInPast={daysInPast},includeAllActive=@includeAllActive)': + get: tags: - admin.adminWindows - summary: Invoke action addMembersById - description: Add members of the same type to an updatableAssetGroup. You can also use the method addMembers to add members. + summary: Invoke function getKnownIssuesByTimeRange + description: Get known issues related to a particular product based on a specified timeframe in the past. externalDocs: description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembersbyid?view=graph-rest-beta - operationId: admin.window.update.updatableAsset_addMembersGraphBPreId + url: https://learn.microsoft.com/graph/api/windowsupdates-product-getknownissuesbytimerange?view=graph-rest-beta + operationId: admin.window.update.product_getKnownIssuesGraphBPreTimeRange parameters: - - name: updatableAsset-id + - name: product-id in: path - description: The unique identifier of updatableAsset + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatableAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - ids: - type: array - items: - type: string - nullable: true - memberEntityType: - type: string - nullable: true - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembers': - post: - tags: - - admin.adminWindows - summary: Invoke action removeMembers - description: Remove members from an updatableAssetGroup. You can also use the method removeMembersById to remove members. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembers?view=graph-rest-beta - operationId: admin.window.update.updatableAsset_removeMember - parameters: - - name: updatableAsset-id + x-ms-docs-key-type: product + - name: daysInPast in: path - description: The unique identifier of updatableAsset + description: 'Usage: daysInPast={daysInPast}' required: true style: simple schema: - type: string - x-ms-docs-key-type: updatableAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembersById': - post: - tags: - - admin.adminWindows - summary: Invoke action removeMembersById - description: Remove members of the same type from an updatableAssetGroup. You can also use the method removeMembers to remove members. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembersbyid?view=graph-rest-beta - operationId: admin.window.update.updatableAsset_removeMembersGraphBPreId - parameters: - - name: updatableAsset-id - in: path - description: The unique identifier of updatableAsset - required: true - style: simple + maximum: 2147483647 + minimum: -2147483648 + type: number + format: int32 + - name: includeAllActive + in: query + description: 'Usage: includeAllActive=@includeAllActive' + style: form + explode: false schema: - type: string - x-ms-docs-key-type: updatableAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - ids: - type: array - items: - type: string - nullable: true - memberEntityType: - type: string - nullable: true - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - /admin/windows/updates/updatableAssets/$count: - get: - tags: - - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.updatableAsset_GetCount - parameters: + type: boolean + default: false + nullable: true + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.enrollAssets: - post: - tags: - - admin.adminWindows - summary: Invoke action enrollAssets - description: 'Enroll updatableAsset resources in update management by Windows Autopatch. You can enroll an azureADDevice resource in update management, but may not enroll an updatableAssetGroup in update management. Enrolling a Microsoft Entra device in update management automatically creates an azureADDevice object if it does not already exist. You can also use the method enrollAssetsById to enroll assets.' - operationId: admin.window.update.updatableAsset_enrollAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.enrollAssetsById: - post: - tags: - - admin.adminWindows - summary: Invoke action enrollAssetsById - description: Enroll updatableAsset resources of the same type in update management by Windows Autopatch. You can also use the method enrollAssets to enroll assets. - operationId: admin.window.update.updatableAsset_enrollAssetsGraphBPreId - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - memberEntityType: - type: string - nullable: true - ids: - type: array - items: - type: string - nullable: true - additionalProperties: - type: object - required: true + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + 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: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.unenrollAssets: - post: - tags: - - admin.adminWindows - summary: Invoke action unenrollAssets - description: Unenroll updatableAsset resources from update management by Windows Autopatch. You can also use the method unenrollAssetsById to unenroll assets. - operationId: admin.window.update.updatableAsset_unenrollAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: + content: + application/json: + schema: + title: Collection of knownIssue type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.unenrollAssetsById: - post: - tags: - - admin.adminWindows - summary: Invoke action unenrollAssetsById - description: Unenroll updatableAsset resources of the same type from update management by Windows Autopatch. You can also use the method unenrollAssets to unenroll assets. - operationId: admin.window.update.updatableAsset_unenrollAssetsGraphBPreId - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - memberEntityType: - type: string - nullable: true - ids: - type: array - items: + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + '@odata.nextLink': type: string nullable: true - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success + additionalProperties: + type: object default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - /admin/windows/updates/updatePolicies: + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/admin/windows/updates/products/{product-id}/revisions': get: tags: - admin.adminWindows - summary: List updatePolicy - description: Get a list of updatePolicy objects and their properties. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/adminwindowsupdates-list-updatepolicies?view=graph-rest-beta - operationId: admin.window.update_ListUpdatePolicy + summary: Get revisions from admin + description: Represents a product revision. + operationId: admin.window.update.product_ListRevision parameters: + - name: product-id + in: path + description: The unique identifier of product + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: product - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -7118,7 +7132,7 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.updatePolicyCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.productRevisionCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -7128,18 +7142,23 @@ paths: post: tags: - admin.adminWindows - summary: Create updatePolicy - description: Create a new updatePolicy object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/adminwindowsupdates-post-updatepolicies?view=graph-rest-beta - operationId: admin.window.update_CreateUpdatePolicy + summary: Create new navigation property to revisions for admin + operationId: admin.window.update.product_CreateRevision + parameters: + - name: product-id + in: path + description: The unique identifier of product + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: product requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' required: true responses: 2XX: @@ -7147,29 +7166,34 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}': + '/admin/windows/updates/products/{product-id}/revisions/{productRevision-id}': get: tags: - admin.adminWindows - summary: Get updatePolicy - description: Read the properties and relationships of an updatePolicy object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-get?view=graph-rest-beta - operationId: admin.window.update_GetUpdatePolicy + summary: Get revisions from admin + description: Represents a product revision. + operationId: admin.window.update.product_GetRevision parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: productRevision - name: $select in: query description: Select properties to be returned @@ -7196,34 +7220,38 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update updatePolicy - description: Update the properties of an updatePolicy object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-update?view=graph-rest-beta - operationId: admin.window.update_UpdateUpdatePolicy + summary: Update the navigation property revisions in admin + operationId: admin.window.update.product_UpdateRevision parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: productRevision requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' required: true responses: 2XX: @@ -7231,28 +7259,32 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete updatePolicy - description: Delete an updatePolicy object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-delete?view=graph-rest-beta - operationId: admin.window.update_DeleteUpdatePolicy + summary: Delete navigation property revisions for admin + operationId: admin.window.update.product_DeleteRevision parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: productRevision - name: If-Match in: header description: ETag @@ -7265,22 +7297,29 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience': + '/admin/windows/updates/products/{product-id}/revisions/{productRevision-id}/catalogEntry': get: tags: - admin.adminWindows - summary: Get audience from admin - description: Specifies the audience to target. - operationId: admin.window.update.updatePolicy_GetAudience + summary: Get catalogEntry from admin + operationId: admin.window.update.product.revision_GetCatalogEntry parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: productRevision - name: $select in: query description: Select properties to be returned @@ -7307,30 +7346,38 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property audience in admin - operationId: admin.window.update.updatePolicy_UpdateAudience + summary: Update the navigation property catalogEntry in admin + operationId: admin.window.update.product.revision_UpdateCatalogEntry parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: productRevision requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' required: true responses: 2XX: @@ -7338,24 +7385,32 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property audience for admin - operationId: admin.window.update.updatePolicy_DeleteAudience + summary: Delete navigation property catalogEntry for admin + operationId: admin.window.update.product.revision_DeleteCatalogEntry parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: productRevision - name: If-Match in: header description: ETag @@ -7368,37 +7423,30 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent': + '/admin/windows/updates/products/{product-id}/revisions/{productRevision-id}/knowledgeBaseArticle': get: tags: - admin.adminWindows - summary: Get applicableContent from admin - description: Content eligible to deploy to devices in the audience. Not nullable. Read-only. - operationId: admin.window.update.updatePolicy.audience_ListApplicableContent + summary: Get knowledgeBaseArticle from admin + description: The knowledge base article associated with the product revision. + operationId: admin.window.update.product.revision_GetKnowledgeBaseArticle parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy - - $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 + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple schema: - uniqueItems: true - type: array - items: - type: string + type: string + x-ms-docs-key-type: productRevision - name: $select in: query description: Select properties to be returned @@ -7421,195 +7469,219 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.applicableContentCollectionResponse' + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' default: $ref: '#/components/responses/error' - x-ms-pageable: - nextLinkName: '@odata.nextLink' - operationName: listMore x-ms-docs-operation-type: operation - post: + patch: tags: - admin.adminWindows - summary: Create new navigation property to applicableContent for admin - operationId: admin.window.update.updatePolicy.audience_CreateApplicableContent + summary: Update the navigation property knowledgeBaseArticle in admin + operationId: admin.window.update.product.revision_UpdateKnowledgeBaseArticle parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: product + - name: productRevision-id + in: path + description: The unique identifier of productRevision + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: productRevision requestBody: - description: New navigation property + description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' required: true responses: 2XX: - description: Created navigation property. + description: Success content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}': - get: + delete: tags: - admin.adminWindows - summary: Get applicableContent from admin - description: Content eligible to deploy to devices in the audience. Not nullable. Read-only. - operationId: admin.window.update.updatePolicy.audience_GetApplicableContent + summary: Delete navigation property knowledgeBaseArticle for admin + operationId: admin.window.update.product.revision_DeleteKnowledgeBaseArticle parameters: - - name: updatePolicy-id + - name: product-id in: path - description: The unique identifier of updatePolicy + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId + x-ms-docs-key-type: product + - name: productRevision-id in: path - description: The unique identifier of applicableContent + description: The unique identifier of productRevision required: true style: simple schema: type: string - x-ms-docs-key-type: applicableContent - - 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 + x-ms-docs-key-type: productRevision + - name: If-Match + in: header + description: ETag + style: simple schema: - uniqueItems: true - type: array - items: - type: string + type: string responses: 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' + description: Success default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - patch: + '/admin/windows/updates/products/{product-id}/revisions/$count': + get: tags: - admin.adminWindows - summary: Update the navigation property applicableContent in admin - operationId: admin.window.update.updatePolicy.audience_UpdateApplicableContent + summary: Get the number of the resource + operationId: admin.window.update.product.revision_GetCount parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId + - name: product-id in: path - description: The unique identifier of applicableContent + description: The unique identifier of product required: true style: simple schema: type: string - x-ms-docs-key-type: applicableContent - requestBody: - description: New navigation property values - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' - required: true + x-ms-docs-key-type: product + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' responses: 2XX: - description: Success - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' + $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - delete: + /admin/windows/updates/products/$count: + get: tags: - admin.adminWindows - summary: Delete navigation property applicableContent for admin - operationId: admin.window.update.updatePolicy.audience_DeleteApplicableContent + summary: Get the number of the resource + operationId: admin.window.update.product_GetCount parameters: - - name: updatePolicy-id + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/admin/windows/updates/products/microsoft.graph.windowsUpdates.findByCatalogId(catalogID=''{catalogID}'')': + get: + tags: + - admin.adminWindows + summary: Invoke function findByCatalogId + operationId: admin.window.update.product_findGraphBPreCatalogId + parameters: + - name: catalogID in: path - description: The unique identifier of updatePolicy + description: 'Usage: catalogID=''{catalogID}''' required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId - in: path - description: The unique identifier of applicableContent - required: true - style: simple + nullable: true + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false schema: - type: string - x-ms-docs-key-type: applicableContent - - name: If-Match - in: header - description: ETag - style: simple + uniqueItems: true + type: array + items: + type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false schema: - type: string + 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: Success + content: + application/json: + schema: + title: Collection of product + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/catalogEntry': + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + '/admin/windows/updates/products/microsoft.graph.windowsUpdates.findByKbNumber(kbNumber={kbNumber})': get: tags: - admin.adminWindows - summary: Get catalogEntry from admin - description: Catalog entry for the update or content. - operationId: admin.window.update.updatePolicy.audience.applicableContent_GetCatalogEntry + summary: Invoke function findByKbNumber + operationId: admin.window.update.product_findGraphBPreKbNumber parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId + - name: kbNumber in: path - description: The unique identifier of applicableContent + description: 'Usage: kbNumber={kbNumber}' required: true style: simple schema: - type: string - x-ms-docs-key-type: applicableContent + maximum: 2147483647 + minimum: -2147483648 + type: number + format: int32 + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' - name: $select in: query description: Select properties to be returned @@ -7620,6 +7692,16 @@ paths: type: array items: type: string + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string - name: $expand in: query description: Expand related entities @@ -7632,38 +7714,39 @@ paths: type: string responses: 2XX: - description: Retrieved navigation property + description: Success content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + title: Collection of product + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/matchedDevices': + x-ms-docs-operation-type: function + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + /admin/windows/updates/resourceConnections: get: tags: - admin.adminWindows - summary: Get matchedDevices from admin - description: Collection of devices and recommendations for applicable catalog content. - operationId: admin.window.update.updatePolicy.audience.applicableContent_ListMatchedDevice + summary: List resourceConnections + description: Get a list of the resourceConnection objects and their properties. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/adminwindowsupdates-list-resourceconnections?view=graph-rest-beta + operationId: admin.window.update_ListResourceConnection parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId - in: path - description: The unique identifier of applicableContent - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: applicableContent - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -7701,7 +7784,7 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.applicableContentDeviceMatchCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.resourceConnectionCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -7711,31 +7794,18 @@ paths: post: tags: - admin.adminWindows - summary: Create new navigation property to matchedDevices for admin - operationId: admin.window.update.updatePolicy.audience.applicableContent_CreateMatchedDevice - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId - in: path - description: The unique identifier of applicableContent - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: applicableContent + summary: Create operationalInsightsConnection + description: Create a new operationalInsightsConnection object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection?view=graph-rest-beta + operationId: admin.window.update_CreateResourceConnection requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' required: true responses: 2XX: @@ -7743,42 +7813,29 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/matchedDevices/{applicableContentDeviceMatch-deviceId}': + '/admin/windows/updates/resourceConnections/{resourceConnection-id}': get: tags: - admin.adminWindows - summary: Get matchedDevices from admin - description: Collection of devices and recommendations for applicable catalog content. - operationId: admin.window.update.updatePolicy.audience.applicableContent_GetMatchedDevice + summary: Get operationalInsightsConnection + description: Read the properties and relationships of an operationalInsightsConnection object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-operationalinsightsconnection-get?view=graph-rest-beta + operationId: admin.window.update_GetResourceConnection parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId - in: path - description: The unique identifier of applicableContent - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: applicableContent - - name: applicableContentDeviceMatch-deviceId + - name: resourceConnection-id in: path - description: The unique identifier of applicableContentDeviceMatch + description: The unique identifier of resourceConnection required: true style: simple schema: type: string - x-ms-docs-key-type: applicableContentDeviceMatch + x-ms-docs-key-type: resourceConnection - name: $select in: query description: Select properties to be returned @@ -7805,46 +7862,30 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property matchedDevices in admin - operationId: admin.window.update.updatePolicy.audience.applicableContent_UpdateMatchedDevice + summary: Update the navigation property resourceConnections in admin + operationId: admin.window.update_UpdateResourceConnection parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId - in: path - description: The unique identifier of applicableContent - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: applicableContent - - name: applicableContentDeviceMatch-deviceId + - name: resourceConnection-id in: path - description: The unique identifier of applicableContentDeviceMatch + description: The unique identifier of resourceConnection required: true style: simple schema: type: string - x-ms-docs-key-type: applicableContentDeviceMatch + x-ms-docs-key-type: resourceConnection requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' required: true responses: 2XX: @@ -7852,40 +7893,28 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property matchedDevices for admin - operationId: admin.window.update.updatePolicy.audience.applicableContent_DeleteMatchedDevice + summary: Delete operationalInsightsConnection + description: Delete an operationalInsightsConnection object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-operationalinsightsconnection-delete?view=graph-rest-beta + operationId: admin.window.update_DeleteResourceConnection parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId - in: path - description: The unique identifier of applicableContent - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: applicableContent - - name: applicableContentDeviceMatch-deviceId + - name: resourceConnection-id in: path - description: The unique identifier of applicableContentDeviceMatch + description: The unique identifier of resourceConnection required: true style: simple schema: type: string - x-ms-docs-key-type: applicableContentDeviceMatch + x-ms-docs-key-type: resourceConnection - name: If-Match in: header description: ETag @@ -7898,51 +7927,13 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/matchedDevices/$count': - get: - tags: - - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.updatePolicy.audience.applicableContent.matchedDevice_GetCount - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - - name: applicableContent-catalogEntryId - in: path - description: The unique identifier of applicableContent - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: applicableContent - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - responses: - 2XX: - $ref: '#/components/responses/ODataCountResponse' - default: - $ref: '#/components/responses/error' - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/$count': + /admin/windows/updates/resourceConnections/$count: get: tags: - admin.adminWindows summary: Get the number of the resource - operationId: admin.window.update.updatePolicy.audience.applicableContent_GetCount + operationId: admin.window.update.resourceConnection_GetCount parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -7950,22 +7941,17 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions': + /admin/windows/updates/updatableAssets: get: tags: - admin.adminWindows - summary: Get exclusions from admin - description: Specifies the assets to exclude from the audience. - operationId: admin.window.update.updatePolicy.audience_ListExclusion + summary: List updatableAssets + description: 'Get a list of updatableAsset objects and their properties. Listing updatable assets returns updatableAsset resources of the following derived types: azureADDevice and updatableAssetGroup. Use list azureADDevice resources or list updatableAssetGroup resources to filter and get resources of only one of the derived types.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/adminwindowsupdates-list-updatableassets?view=graph-rest-beta + operationId: admin.window.update_ListUpdatableAsset parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -8013,17 +7999,12 @@ paths: post: tags: - admin.adminWindows - summary: Create new navigation property to exclusions for admin - operationId: admin.window.update.updatePolicy.audience_CreateExclusion - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy + summary: Create updatableAssetGroup + description: Create a new updatableAssetGroup object. The updatableAssetGroup resource inherits from updatableAsset. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/adminwindowsupdates-post-updatableassets-updatableassetgroup?view=graph-rest-beta + operationId: admin.window.update_CreateUpdatableAsset requestBody: description: New navigation property content: @@ -8041,22 +8022,17 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}': + '/admin/windows/updates/updatableAssets/{updatableAsset-id}': get: tags: - admin.adminWindows - summary: Get exclusions from admin - description: Specifies the assets to exclude from the audience. - operationId: admin.window.update.updatePolicy.audience_GetExclusion + summary: Get azureADDevice + description: Read the properties of an azureADDevice object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-azureaddevice-get?view=graph-rest-beta + operationId: admin.window.update_GetUpdatableAsset parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - name: updatableAsset-id in: path description: The unique identifier of updatableAsset @@ -8098,17 +8074,9 @@ paths: patch: tags: - admin.adminWindows - summary: Update the navigation property exclusions in admin - operationId: admin.window.update.updatePolicy.audience_UpdateExclusion + summary: Update the navigation property updatableAssets in admin + operationId: admin.window.update_UpdateUpdatableAsset parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - name: updatableAsset-id in: path description: The unique identifier of updatableAsset @@ -8137,17 +8105,13 @@ paths: delete: tags: - admin.adminWindows - summary: Delete navigation property exclusions for admin - operationId: admin.window.update.updatePolicy.audience_DeleteExclusion + summary: Delete azureADDevice + description: 'Delete an azureADDevice object. When a Microsoft Entra device is deleted, it is unregistered and automatically unenrolled from management for all update categories, as well as removed from every deploymentAudience and updatableAssetGroup.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-azureaddevice-delete?view=graph-rest-beta + operationId: admin.window.update_DeleteUpdatableAsset parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - name: updatableAsset-id in: path description: The unique identifier of updatableAsset @@ -8168,7 +8132,7 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembers': + '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembers': post: tags: - admin.adminWindows @@ -8177,16 +8141,8 @@ paths: externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.exclusion_addMember + operationId: admin.window.update.updatableAsset_addMember parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - name: updatableAsset-id in: path description: The unique identifier of updatableAsset @@ -8215,7 +8171,7 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembersById': + '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembersById': post: tags: - admin.adminWindows @@ -8224,16 +8180,8 @@ paths: externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembersbyid?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.exclusion_addMembersGraphBPreId + operationId: admin.window.update.updatableAsset_addMembersGraphBPreId parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - name: updatableAsset-id in: path description: The unique identifier of updatableAsset @@ -8266,7 +8214,7 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembers': + '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembers': post: tags: - admin.adminWindows @@ -8275,16 +8223,8 @@ paths: externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembers?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.exclusion_removeMember + operationId: admin.window.update.updatableAsset_removeMember parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - name: updatableAsset-id in: path description: The unique identifier of updatableAsset @@ -8313,7 +8253,7 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembersById': + '/admin/windows/updates/updatableAssets/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembersById': post: tags: - admin.adminWindows @@ -8322,16 +8262,8 @@ paths: externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembersbyid?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.exclusion_removeMembersGraphBPreId + operationId: admin.window.update.updatableAsset_removeMembersGraphBPreId parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - name: updatableAsset-id in: path description: The unique identifier of updatableAsset @@ -8364,21 +8296,13 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/$count': + /admin/windows/updates/updatableAssets/$count: get: tags: - admin.adminWindows summary: Get the number of the resource - operationId: admin.window.update.updatePolicy.audience.exclusion_GetCount + operationId: admin.window.update.updatableAsset_GetCount parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -8386,21 +8310,13 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.enrollAssets': + /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.enrollAssets: post: tags: - admin.adminWindows summary: Invoke action enrollAssets - operationId: admin.window.update.updatePolicy.audience.exclusion_enrollAsset - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy + description: 'Enroll updatableAsset resources in update management by Windows Autopatch. You can enroll an azureADDevice resource in update management, but may not enroll an updatableAssetGroup in update management. Enrolling a Microsoft Entra device in update management automatically creates an azureADDevice object if it does not already exist. You can also use the method enrollAssetsById to enroll assets.' + operationId: admin.window.update.updatableAsset_enrollAsset requestBody: description: Action parameters content: @@ -8423,21 +8339,13 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.enrollAssetsById': + /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.enrollAssetsById: post: tags: - admin.adminWindows summary: Invoke action enrollAssetsById - operationId: admin.window.update.updatePolicy.audience.exclusion_enrollAssetsGraphBPreId - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy + description: Enroll updatableAsset resources of the same type in update management by Windows Autopatch. You can also use the method enrollAssets to enroll assets. + operationId: admin.window.update.updatableAsset_enrollAssetsGraphBPreId requestBody: description: Action parameters content: @@ -8464,21 +8372,13 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.unenrollAssets': + /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.unenrollAssets: post: tags: - admin.adminWindows summary: Invoke action unenrollAssets - operationId: admin.window.update.updatePolicy.audience.exclusion_unenrollAsset - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy + description: Unenroll updatableAsset resources from update management by Windows Autopatch. You can also use the method unenrollAssetsById to unenroll assets. + operationId: admin.window.update.updatableAsset_unenrollAsset requestBody: description: Action parameters content: @@ -8501,21 +8401,13 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.unenrollAssetsById': + /admin/windows/updates/updatableAssets/microsoft.graph.windowsUpdates.unenrollAssetsById: post: tags: - admin.adminWindows summary: Invoke action unenrollAssetsById - operationId: admin.window.update.updatePolicy.audience.exclusion_unenrollAssetsGraphBPreId - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy + description: Unenroll updatableAsset resources of the same type from update management by Windows Autopatch. You can also use the method unenrollAssets to unenroll assets. + operationId: admin.window.update.updatableAsset_unenrollAssetsGraphBPreId requestBody: description: Action parameters content: @@ -8542,22 +8434,17 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members': + /admin/windows/updates/updatePolicies: get: tags: - admin.adminWindows - summary: Get members from admin - description: Specifies the assets to include in the audience. - operationId: admin.window.update.updatePolicy.audience_ListMember + summary: List updatePolicy + description: Get a list of updatePolicy objects and their properties. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/adminwindowsupdates-list-updatepolicies?view=graph-rest-beta + operationId: admin.window.update_ListUpdatePolicy parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -8595,7 +8482,7 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.updatableAssetCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.updatePolicyCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -8605,23 +8492,18 @@ paths: post: tags: - admin.adminWindows - summary: Create new navigation property to members for admin - operationId: admin.window.update.updatePolicy.audience_CreateMember - parameters: - - name: updatePolicy-id - in: path - description: The unique identifier of updatePolicy - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatePolicy + summary: Create updatePolicy + description: Create a new updatePolicy object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/adminwindowsupdates-post-updatepolicies?view=graph-rest-beta + operationId: admin.window.update_CreateUpdatePolicy requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' required: true responses: 2XX: @@ -8629,17 +8511,20 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}': + '/admin/windows/updates/updatePolicies/{updatePolicy-id}': get: tags: - admin.adminWindows - summary: Get members from admin - description: Specifies the assets to include in the audience. - operationId: admin.window.update.updatePolicy.audience_GetMember + summary: Get updatePolicy + description: Read the properties and relationships of an updatePolicy object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-get?view=graph-rest-beta + operationId: admin.window.update_GetUpdatePolicy parameters: - name: updatePolicy-id in: path @@ -8649,14 +8534,6 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: updatableAsset-id - in: path - description: The unique identifier of updatableAsset - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatableAsset - name: $select in: query description: Select properties to be returned @@ -8683,15 +8560,19 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update the navigation property members in admin - operationId: admin.window.update.updatePolicy.audience_UpdateMember + summary: Update updatePolicy + description: Update the properties of an updatePolicy object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-update?view=graph-rest-beta + operationId: admin.window.update_UpdateUpdatePolicy parameters: - name: updatePolicy-id in: path @@ -8701,20 +8582,12 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: updatableAsset-id - in: path - description: The unique identifier of updatableAsset - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatableAsset requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' required: true responses: 2XX: @@ -8722,15 +8595,19 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete navigation property members for admin - operationId: admin.window.update.updatePolicy.audience_DeleteMember + summary: Delete updatePolicy + description: Delete an updatePolicy object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-delete?view=graph-rest-beta + operationId: admin.window.update_DeleteUpdatePolicy parameters: - name: updatePolicy-id in: path @@ -8740,14 +8617,6 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: updatableAsset-id - in: path - description: The unique identifier of updatableAsset - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatableAsset - name: If-Match in: header description: ETag @@ -8760,16 +8629,13 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembers': - post: + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience': + get: tags: - admin.adminWindows - summary: Invoke action addMembers - description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.member_addMember + summary: Get audience from admin + description: Specifies the audience to target. + operationId: admin.window.update.updatePolicy_GetAudience parameters: - name: updatePolicy-id in: path @@ -8779,44 +8645,41 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: updatableAsset-id - in: path - description: The unique identifier of updatableAsset - required: true - style: simple + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false schema: - type: string - x-ms-docs-key-type: updatableAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object - required: true + 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: Success + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembersById': - post: + x-ms-docs-operation-type: operation + patch: tags: - admin.adminWindows - summary: Invoke action addMembersById - description: Add members of the same type to an updatableAssetGroup. You can also use the method addMembers to add members. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembersbyid?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.member_addMembersGraphBPreId + summary: Update the navigation property audience in admin + operationId: admin.window.update.updatePolicy_UpdateAudience parameters: - name: updatePolicy-id in: path @@ -8826,48 +8689,28 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: updatableAsset-id - in: path - description: The unique identifier of updatableAsset - required: true - style: simple - schema: - type: string - x-ms-docs-key-type: updatableAsset requestBody: - description: Action parameters + description: New navigation property values content: application/json: schema: - type: object - properties: - ids: - type: array - items: - type: string - nullable: true - memberEntityType: - type: string - nullable: true - additionalProperties: - type: object + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' required: true responses: 2XX: description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembers': - post: + x-ms-docs-operation-type: operation + delete: tags: - admin.adminWindows - summary: Invoke action removeMembers - description: Remove members from an updatableAssetGroup. You can also use the method removeMembersById to remove members. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembers?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.member_removeMember + summary: Delete navigation property audience for admin + operationId: admin.window.update.updatePolicy_DeleteAudience parameters: - name: updatePolicy-id in: path @@ -8877,44 +8720,25 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: updatableAsset-id - in: path - description: The unique identifier of updatableAsset - required: true + - name: If-Match + in: header + description: ETag style: simple schema: type: string - x-ms-docs-key-type: updatableAsset - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object - required: true responses: 2XX: description: Success default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembersById': - post: + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent': + get: tags: - admin.adminWindows - summary: Invoke action removeMembersById - description: Remove members of the same type from an updatableAssetGroup. You can also use the method removeMembers to remove members. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembersbyid?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience.member_removeMembersGraphBPreId + summary: Get applicableContent from admin + description: Content eligible to deploy to devices in the audience. Not nullable. Read-only. + operationId: admin.window.update.updatePolicy.audience_ListApplicableContent parameters: - name: updatePolicy-id in: path @@ -8924,44 +8748,88 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: updatableAsset-id + - $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.windowsUpdates.applicableContentCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - admin.adminWindows + summary: Create new navigation property to applicableContent for admin + operationId: admin.window.update.updatePolicy.audience_CreateApplicableContent + parameters: + - name: updatePolicy-id in: path - description: The unique identifier of updatableAsset + description: The unique identifier of updatePolicy required: true style: simple schema: type: string - x-ms-docs-key-type: updatableAsset + x-ms-docs-key-type: updatePolicy requestBody: - description: Action parameters + description: New navigation property content: application/json: schema: - type: object - properties: - ids: - type: array - items: - type: string - nullable: true - memberEntityType: - type: string - nullable: true - additionalProperties: - type: object + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' required: true responses: 2XX: - description: Success + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/$count': + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}': get: tags: - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.updatePolicy.audience.member_GetCount + summary: Get applicableContent from admin + description: Content eligible to deploy to devices in the audience. Not nullable. Read-only. + operationId: admin.window.update.updatePolicy.audience_GetApplicableContent parameters: - name: updatePolicy-id in: path @@ -8971,19 +8839,49 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' + - name: applicableContent-catalogEntryId + in: path + description: The unique identifier of applicableContent + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContent + - 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/ODataCountResponse' + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' default: $ref: '#/components/responses/error' - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.enrollAssets': - post: + x-ms-docs-operation-type: operation + patch: tags: - admin.adminWindows - summary: Invoke action enrollAssets - operationId: admin.window.update.updatePolicy.audience.member_enrollAsset + summary: Update the navigation property applicableContent in admin + operationId: admin.window.update.updatePolicy.audience_UpdateApplicableContent parameters: - name: updatePolicy-id in: path @@ -8993,34 +8891,36 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy + - name: applicableContent-catalogEntryId + in: path + description: The unique identifier of applicableContent + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContent requestBody: - description: Action parameters + description: New navigation property values content: application/json: schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' required: true responses: 2XX: description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.enrollAssetsById': - post: + x-ms-docs-operation-type: operation + delete: tags: - admin.adminWindows - summary: Invoke action enrollAssetsById - operationId: admin.window.update.updatePolicy.audience.member_enrollAssetsGraphBPreId + summary: Delete navigation property applicableContent for admin + operationId: admin.window.update.updatePolicy.audience_DeleteApplicableContent parameters: - name: updatePolicy-id in: path @@ -9030,75 +8930,33 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - memberEntityType: - type: string - nullable: true - ids: - type: array - items: - type: string - nullable: true - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.unenrollAssets': - post: - tags: - - admin.adminWindows - summary: Invoke action unenrollAssets - operationId: admin.window.update.updatePolicy.audience.member_unenrollAsset - parameters: - - name: updatePolicy-id + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of updatePolicy + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - assets: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object - required: true + x-ms-docs-key-type: applicableContent + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string responses: 2XX: description: Success default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.unenrollAssetsById': - post: + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/catalogEntry': + get: tags: - admin.adminWindows - summary: Invoke action unenrollAssetsById - operationId: admin.window.update.updatePolicy.audience.member_unenrollAssetsGraphBPreId + summary: Get catalogEntry from admin + description: Catalog entry for the update or content. + operationId: admin.window.update.updatePolicy.audience.applicableContent_GetCatalogEntry parameters: - name: updatePolicy-id in: path @@ -9108,93 +8966,51 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - updateCategory: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' - memberEntityType: - type: string - nullable: true - ids: - type: array - items: - type: string - nullable: true - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/microsoft.graph.windowsUpdates.updateAudience': - post: - tags: - - admin.adminWindows - summary: Invoke action updateAudience - description: 'Update the members and exclusions relationships of a deploymentAudience. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object, if it doesn''t already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, the deployment doesn''t apply to that asset. If all updatableAsset objects are the same type, you can also use the method updateAudienceById to update the deploymentAudience.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-deploymentaudience-updateaudience?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience_updateAudience - parameters: - - name: updatePolicy-id + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of updatePolicy + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - addMembers: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - removeMembers: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - addExclusions: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - removeExclusions: - type: array - items: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' - additionalProperties: - type: object - required: true + x-ms-docs-key-type: applicableContent + - 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: Success + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' default: $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/microsoft.graph.windowsUpdates.updateAudienceById': - post: + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/matchedDevices': + get: tags: - admin.adminWindows - summary: Invoke action updateAudienceById - description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it does not already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.' - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-deploymentaudience-updateaudiencebyid?view=graph-rest-beta - operationId: admin.window.update.updatePolicy.audience_updateAudienceGraphBPreId + summary: Get matchedDevices from admin + description: Collection of devices and recommendations for applicable catalog content. + operationId: admin.window.update.updatePolicy.audience.applicableContent_ListMatchedDevice parameters: - name: updatePolicy-id in: path @@ -9204,64 +9020,14 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - requestBody: - description: Action parameters - content: - application/json: - schema: - type: object - properties: - memberEntityType: - type: string - nullable: true - addMembers: - type: array - items: - type: string - nullable: true - removeMembers: - type: array - items: - type: string - nullable: true - addExclusions: - type: array - items: - type: string - nullable: true - removeExclusions: - type: array - items: - type: string - nullable: true - additionalProperties: - type: object - required: true - responses: - 2XX: - description: Success - default: - $ref: '#/components/responses/error' - x-ms-docs-operation-type: action - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges': - get: - tags: - - admin.adminWindows - summary: List complianceChanges - description: Get a list of the complianceChange objects and their properties. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-list-compliancechanges?view=graph-rest-beta - operationId: admin.window.update.updatePolicy_ListComplianceChange - parameters: - - name: updatePolicy-id + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of updatePolicy + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: updatePolicy + x-ms-docs-key-type: applicableContent - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -9299,7 +9065,7 @@ paths: type: string responses: 2XX: - $ref: '#/components/responses/microsoft.graph.windowsUpdates.complianceChangeCollectionResponse' + $ref: '#/components/responses/microsoft.graph.windowsUpdates.applicableContentDeviceMatchCollectionResponse' default: $ref: '#/components/responses/error' x-ms-pageable: @@ -9309,12 +9075,8 @@ paths: post: tags: - admin.adminWindows - summary: Create contentApproval - description: Create a new contentApproval object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-post-compliancechanges-contentapproval?view=graph-rest-beta - operationId: admin.window.update.updatePolicy_CreateComplianceChange + summary: Create new navigation property to matchedDevices for admin + operationId: admin.window.update.updatePolicy.audience.applicableContent_CreateMatchedDevice parameters: - name: updatePolicy-id in: path @@ -9324,12 +9086,20 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy + - name: applicableContent-catalogEntryId + in: path + description: The unique identifier of applicableContent + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContent requestBody: description: New navigation property content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' required: true responses: 2XX: @@ -9337,20 +9107,17 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges/{complianceChange-id}': + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/matchedDevices/{applicableContentDeviceMatch-deviceId}': get: tags: - admin.adminWindows - summary: Get complianceChange - description: Read the properties and relationships of a complianceChange object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-compliancechange-get?view=graph-rest-beta - operationId: admin.window.update.updatePolicy_GetComplianceChange + summary: Get matchedDevices from admin + description: Collection of devices and recommendations for applicable catalog content. + operationId: admin.window.update.updatePolicy.audience.applicableContent_GetMatchedDevice parameters: - name: updatePolicy-id in: path @@ -9360,17 +9127,25 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: complianceChange-id + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of complianceChange + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: complianceChange - - name: $select - in: query - description: Select properties to be returned + x-ms-docs-key-type: applicableContent + - name: applicableContentDeviceMatch-deviceId + in: path + description: The unique identifier of applicableContentDeviceMatch + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContentDeviceMatch + - name: $select + in: query + description: Select properties to be returned style: form explode: false schema: @@ -9394,19 +9169,15 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation patch: tags: - admin.adminWindows - summary: Update complianceChange - description: Update the properties of a complianceChange object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-compliancechange-update?view=graph-rest-beta - operationId: admin.window.update.updatePolicy_UpdateComplianceChange + summary: Update the navigation property matchedDevices in admin + operationId: admin.window.update.updatePolicy.audience.applicableContent_UpdateMatchedDevice parameters: - name: updatePolicy-id in: path @@ -9416,20 +9187,28 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: complianceChange-id + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of complianceChange + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: complianceChange + x-ms-docs-key-type: applicableContent + - name: applicableContentDeviceMatch-deviceId + in: path + description: The unique identifier of applicableContentDeviceMatch + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContentDeviceMatch requestBody: description: New navigation property values content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' required: true responses: 2XX: @@ -9437,19 +9216,15 @@ paths: content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation delete: tags: - admin.adminWindows - summary: Delete complianceChange - description: Delete a complianceChange object. - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/windowsupdates-compliancechange-delete?view=graph-rest-beta - operationId: admin.window.update.updatePolicy_DeleteComplianceChange + summary: Delete navigation property matchedDevices for admin + operationId: admin.window.update.updatePolicy.audience.applicableContent_DeleteMatchedDevice parameters: - name: updatePolicy-id in: path @@ -9459,14 +9234,22 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: complianceChange-id + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of complianceChange + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: complianceChange + x-ms-docs-key-type: applicableContent + - name: applicableContentDeviceMatch-deviceId + in: path + description: The unique identifier of applicableContentDeviceMatch + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: applicableContentDeviceMatch - name: If-Match in: header description: ETag @@ -9479,13 +9262,12 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges/{complianceChange-id}/updatePolicy': + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/{applicableContent-catalogEntryId}/matchedDevices/$count': get: tags: - admin.adminWindows - summary: Get updatePolicy from admin - description: The policy this compliance change is a member of. - operationId: admin.window.update.updatePolicy.complianceChange_GetUpdatePolicy + summary: Get the number of the resource + operationId: admin.window.update.updatePolicy.audience.applicableContent.matchedDevice_GetCount parameters: - name: updatePolicy-id in: path @@ -9495,14 +9277,74 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - name: complianceChange-id + - name: applicableContent-catalogEntryId in: path - description: The unique identifier of complianceChange + description: The unique identifier of applicableContent required: true style: simple schema: type: string - x-ms-docs-key-type: complianceChange + x-ms-docs-key-type: applicableContent + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/applicableContent/$count': + get: + tags: + - admin.adminWindows + summary: Get the number of the resource + operationId: admin.window.update.updatePolicy.audience.applicableContent_GetCount + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions': + get: + tags: + - admin.adminWindows + summary: Get exclusions from admin + description: Specifies the assets to exclude from the audience. + operationId: admin.window.update.updatePolicy.audience_ListExclusion + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - $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 @@ -9525,20 +9367,51 @@ paths: type: string responses: 2XX: - description: Retrieved navigation property + $ref: '#/components/responses/microsoft.graph.windowsUpdates.updatableAssetCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - admin.adminWindows + summary: Create new navigation property to exclusions for admin + operationId: admin.window.update.updatePolicy.audience_CreateExclusion + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + required: true + responses: + 2XX: + description: Created navigation property. content: application/json: schema: - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation - '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges/$count': + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}': get: tags: - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.updatePolicy.complianceChange_GetCount + summary: Get exclusions from admin + description: Specifies the assets to exclude from the audience. + operationId: admin.window.update.updatePolicy.audience_GetExclusion parameters: - name: updatePolicy-id in: path @@ -9548,1022 +9421,31804 @@ paths: schema: type: string x-ms-docs-key-type: updatePolicy - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + - 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/ODataCountResponse' + description: Retrieved navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' default: $ref: '#/components/responses/error' - /admin/windows/updates/updatePolicies/$count: - get: + x-ms-docs-operation-type: operation + patch: tags: - admin.adminWindows - summary: Get the number of the resource - operationId: admin.window.update.updatePolicy_GetCount + summary: Update the navigation property exclusions in admin + operationId: admin.window.update.updatePolicy.audience_UpdateExclusion parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + required: true responses: 2XX: - $ref: '#/components/responses/ODataCountResponse' + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' default: $ref: '#/components/responses/error' -components: - schemas: - microsoft.graph.adminWindows: - allOf: - - $ref: '#/components/schemas/microsoft.graph.entity' + x-ms-docs-operation-type: operation + delete: + tags: + - admin.adminWindows + summary: Delete navigation property exclusions for admin + operationId: admin.window.update.updatePolicy.audience_DeleteExclusion + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembers': + post: + tags: + - admin.adminWindows + summary: Invoke action addMembers + description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.exclusion_addMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembersById': + post: + tags: + - admin.adminWindows + summary: Invoke action addMembersById + description: Add members of the same type to an updatableAssetGroup. You can also use the method addMembers to add members. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembersbyid?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.exclusion_addMembersGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + ids: + type: array + items: + type: string + nullable: true + memberEntityType: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembers': + post: + tags: + - admin.adminWindows + summary: Invoke action removeMembers + description: Remove members from an updatableAssetGroup. You can also use the method removeMembersById to remove members. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembers?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.exclusion_removeMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembersById': + post: + tags: + - admin.adminWindows + summary: Invoke action removeMembersById + description: Remove members of the same type from an updatableAssetGroup. You can also use the method removeMembers to remove members. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembersbyid?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.exclusion_removeMembersGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + ids: + type: array + items: + type: string + nullable: true + memberEntityType: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/$count': + get: + tags: + - admin.adminWindows + summary: Get the number of the resource + operationId: admin.window.update.updatePolicy.audience.exclusion_GetCount + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.enrollAssets': + post: + tags: + - admin.adminWindows + summary: Invoke action enrollAssets + operationId: admin.window.update.updatePolicy.audience.exclusion_enrollAsset + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.enrollAssetsById': + post: + tags: + - admin.adminWindows + summary: Invoke action enrollAssetsById + operationId: admin.window.update.updatePolicy.audience.exclusion_enrollAssetsGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + memberEntityType: + type: string + nullable: true + ids: + type: array + items: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.unenrollAssets': + post: + tags: + - admin.adminWindows + summary: Invoke action unenrollAssets + operationId: admin.window.update.updatePolicy.audience.exclusion_unenrollAsset + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/exclusions/microsoft.graph.windowsUpdates.unenrollAssetsById': + post: + tags: + - admin.adminWindows + summary: Invoke action unenrollAssetsById + operationId: admin.window.update.updatePolicy.audience.exclusion_unenrollAssetsGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + memberEntityType: + type: string + nullable: true + ids: + type: array + items: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members': + get: + tags: + - admin.adminWindows + summary: Get members from admin + description: Specifies the assets to include in the audience. + operationId: admin.window.update.updatePolicy.audience_ListMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - $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.windowsUpdates.updatableAssetCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - admin.adminWindows + summary: Create new navigation property to members for admin + operationId: admin.window.update.updatePolicy.audience_CreateMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}': + get: + tags: + - admin.adminWindows + summary: Get members from admin + description: Specifies the assets to include in the audience. + operationId: admin.window.update.updatePolicy.audience_GetMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + - 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 navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - admin.adminWindows + summary: Update the navigation property members in admin + operationId: admin.window.update.updatePolicy.audience_UpdateMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - admin.adminWindows + summary: Delete navigation property members for admin + operationId: admin.window.update.updatePolicy.audience_DeleteMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembers': + post: + tags: + - admin.adminWindows + summary: Invoke action addMembers + description: 'Add members to an updatableAssetGroup. You can add azureADDevice resources as members, but may not add updatableAssetGroup resources as members. Adding a Microsoft Entra device as a member of an updatable asset group automatically creates an azureADDevice object, if it does not already exist. You can also use the method addMembersById to add members.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembers?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.member_addMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.addMembersById': + post: + tags: + - admin.adminWindows + summary: Invoke action addMembersById + description: Add members of the same type to an updatableAssetGroup. You can also use the method addMembers to add members. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-addmembersbyid?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.member_addMembersGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + ids: + type: array + items: + type: string + nullable: true + memberEntityType: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembers': + post: + tags: + - admin.adminWindows + summary: Invoke action removeMembers + description: Remove members from an updatableAssetGroup. You can also use the method removeMembersById to remove members. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembers?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.member_removeMember + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/{updatableAsset-id}/microsoft.graph.windowsUpdates.removeMembersById': + post: + tags: + - admin.adminWindows + summary: Invoke action removeMembersById + description: Remove members of the same type from an updatableAssetGroup. You can also use the method removeMembers to remove members. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatableassetgroup-removemembersbyid?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience.member_removeMembersGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: updatableAsset-id + in: path + description: The unique identifier of updatableAsset + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatableAsset + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + ids: + type: array + items: + type: string + nullable: true + memberEntityType: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/$count': + get: + tags: + - admin.adminWindows + summary: Get the number of the resource + operationId: admin.window.update.updatePolicy.audience.member_GetCount + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.enrollAssets': + post: + tags: + - admin.adminWindows + summary: Invoke action enrollAssets + operationId: admin.window.update.updatePolicy.audience.member_enrollAsset + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.enrollAssetsById': + post: + tags: + - admin.adminWindows + summary: Invoke action enrollAssetsById + operationId: admin.window.update.updatePolicy.audience.member_enrollAssetsGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + memberEntityType: + type: string + nullable: true + ids: + type: array + items: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.unenrollAssets': + post: + tags: + - admin.adminWindows + summary: Invoke action unenrollAssets + operationId: admin.window.update.updatePolicy.audience.member_unenrollAsset + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + assets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/members/microsoft.graph.windowsUpdates.unenrollAssetsById': + post: + tags: + - admin.adminWindows + summary: Invoke action unenrollAssetsById + operationId: admin.window.update.updatePolicy.audience.member_unenrollAssetsGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + updateCategory: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updateCategory' + memberEntityType: + type: string + nullable: true + ids: + type: array + items: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/microsoft.graph.windowsUpdates.updateAudience': + post: + tags: + - admin.adminWindows + summary: Invoke action updateAudience + description: 'Update the members and exclusions relationships of a deploymentAudience. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object, if it doesn''t already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, the deployment doesn''t apply to that asset. If all updatableAsset objects are the same type, you can also use the method updateAudienceById to update the deploymentAudience.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-deploymentaudience-updateaudience?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience_updateAudience + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + addMembers: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + removeMembers: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + addExclusions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + removeExclusions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/audience/microsoft.graph.windowsUpdates.updateAudienceById': + post: + tags: + - admin.adminWindows + summary: Invoke action updateAudienceById + description: 'Update the members and exclusions collections of a deploymentAudience with updatableAsset resources of the same type. Adding an azureADDevice to the members or exclusions collections of a deployment audience automatically creates a Microsoft Entra device object if it does not already exist. If the same updatableAsset gets included in the exclusions and members collections of a deploymentAudience, deployment will not apply to that asset. You can also use the method updateAudience to update the deploymentAudience.' + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-deploymentaudience-updateaudiencebyid?view=graph-rest-beta + operationId: admin.window.update.updatePolicy.audience_updateAudienceGraphBPreId + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: Action parameters + content: + application/json: + schema: + type: object + properties: + memberEntityType: + type: string + nullable: true + addMembers: + type: array + items: + type: string + nullable: true + removeMembers: + type: array + items: + type: string + nullable: true + addExclusions: + type: array + items: + type: string + nullable: true + removeExclusions: + type: array + items: + type: string + nullable: true + additionalProperties: + type: object + required: true + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: action + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges': + get: + tags: + - admin.adminWindows + summary: List complianceChanges + description: Get a list of the complianceChange objects and their properties. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-list-compliancechanges?view=graph-rest-beta + operationId: admin.window.update.updatePolicy_ListComplianceChange + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - $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.windowsUpdates.complianceChangeCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - admin.adminWindows + summary: Create contentApproval + description: Create a new contentApproval object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-updatepolicy-post-compliancechanges-contentapproval?view=graph-rest-beta + operationId: admin.window.update.updatePolicy_CreateComplianceChange + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + requestBody: + description: New navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + required: true + responses: + 2XX: + description: Created navigation property. + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges/{complianceChange-id}': + get: + tags: + - admin.adminWindows + summary: Get complianceChange + description: Read the properties and relationships of a complianceChange object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-compliancechange-get?view=graph-rest-beta + operationId: admin.window.update.updatePolicy_GetComplianceChange + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: complianceChange-id + in: path + description: The unique identifier of complianceChange + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: complianceChange + - 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 navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + patch: + tags: + - admin.adminWindows + summary: Update complianceChange + description: Update the properties of a complianceChange object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-compliancechange-update?view=graph-rest-beta + operationId: admin.window.update.updatePolicy_UpdateComplianceChange + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: complianceChange-id + in: path + description: The unique identifier of complianceChange + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: complianceChange + requestBody: + description: New navigation property values + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + required: true + responses: + 2XX: + description: Success + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - admin.adminWindows + summary: Delete complianceChange + description: Delete a complianceChange object. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/windowsupdates-compliancechange-delete?view=graph-rest-beta + operationId: admin.window.update.updatePolicy_DeleteComplianceChange + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: complianceChange-id + in: path + description: The unique identifier of complianceChange + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: complianceChange + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges/{complianceChange-id}/updatePolicy': + get: + tags: + - admin.adminWindows + summary: Get updatePolicy from admin + description: The policy this compliance change is a member of. + operationId: admin.window.update.updatePolicy.complianceChange_GetUpdatePolicy + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - name: complianceChange-id + in: path + description: The unique identifier of complianceChange + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: complianceChange + - 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 navigation property + content: + application/json: + schema: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/admin/windows/updates/updatePolicies/{updatePolicy-id}/complianceChanges/$count': + get: + tags: + - admin.adminWindows + summary: Get the number of the resource + operationId: admin.window.update.updatePolicy.complianceChange_GetCount + parameters: + - name: updatePolicy-id + in: path + description: The unique identifier of updatePolicy + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: updatePolicy + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /admin/windows/updates/updatePolicies/$count: + get: + tags: + - admin.adminWindows + summary: Get the number of the resource + operationId: admin.window.update.updatePolicy_GetCount + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' +components: + schemas: + microsoft.graph.adminWindows: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' - title: adminWindows type: object properties: - updates: - $ref: '#/components/schemas/microsoft.graph.adminWindowsUpdates' + updates: + $ref: '#/components/schemas/microsoft.graph.adminWindowsUpdates' + additionalProperties: + type: object + microsoft.graph.adminWindowsUpdates: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: adminWindowsUpdates + type: object + properties: + catalog: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalog' + deploymentAudiences: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' + description: The set of updatableAsset resources to which a deployment can apply. + x-ms-navigationProperty: true + deployments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deployment' + description: Deployments created using Windows Autopatch. + x-ms-navigationProperty: true + policies: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policy' + description: A collection of policies for approving the deployment of different content to an audience over time. + x-ms-navigationProperty: true + products: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + description: A collection of Windows products. + x-ms-navigationProperty: true + resourceConnections: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' + description: Service connections to external resources such as analytics workspaces. + x-ms-navigationProperty: true + updatableAssets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + description: Assets registered with Windows Autopatch that can receive updates. + x-ms-navigationProperty: true + updatePolicies: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + description: A collection of policies for approving the deployment of different content to an audience over time. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.catalog: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: catalog + type: object + properties: + entries: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + description: Lists the content that you can approve for deployment. Read-only. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.catalogEntry: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: catalogEntry + type: object + properties: + deployableUntilDateTime: + 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 date on which the content is no longer available to deploy. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + displayName: + type: string + description: The display name of the content. Read-only. + nullable: true + releaseDateTime: + 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 release date for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + additionalProperties: + type: object + microsoft.graph.windowsUpdates.deploymentAudience: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: deploymentAudience + type: object + properties: + applicableContent: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' + description: Content eligible to deploy to devices in the audience. Not nullable. Read-only. + x-ms-navigationProperty: true + exclusions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + description: Specifies the assets to exclude from the audience. + x-ms-navigationProperty: true + members: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + description: Specifies the assets to include in the audience. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.applicableContent: + title: applicableContent + type: object + properties: + catalogEntryId: + type: string + description: ID of the catalog entry for the applicable content. + catalogEntry: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + matchedDevices: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' + description: Collection of devices and recommendations for applicable catalog content. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.applicableContentDeviceMatch: + title: applicableContentDeviceMatch + type: object + properties: + deviceId: + type: string + description: Collection of vendors who recommend the content. + recommendedBy: + type: array + items: + type: string + description: Collection of vendors who recommend the content. + additionalProperties: + type: object + microsoft.graph.windowsUpdates.updatableAsset: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: updatableAsset + type: object + additionalProperties: + type: object + microsoft.graph.windowsUpdates.updateCategory: + title: updateCategory + enum: + - feature + - quality + - unknownFutureValue + - driver + type: string + microsoft.graph.windowsUpdates.deployment: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: deployment + type: object + properties: + content: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deployableContent' + 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: The date and time the deployment was created. Returned by default. Read-only. + format: date-time + lastModifiedDateTime: + 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 date and time the deployment was last modified. Returned by default. Read-only. + format: date-time + settings: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentSettings' + state: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentState' + audience: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.policy: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: policy + type: object + properties: + approvalRules: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.approvalRule' + description: The approved rule of the policy that determines which published content matches the rule on an ongoing basis. + 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: 'The date and time when the policy is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + description: + type: string + description: 'The policy description. The maximum length is 1,500 characters.' + displayName: + type: string + description: The policy display name. The maximum length is 200 characters. + lastModifiedDateTime: + 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 date and time when the policy was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + applicableContent: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' + description: Represents content applicable for offering to the related collection of devices. + x-ms-navigationProperty: true + approvals: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policyApproval' + description: Represents a set of quality updates policy approval types. + x-ms-navigationProperty: true + rings: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.ring' + description: Represents a set of deployment rings that contains update deployment settings. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.policyApproval: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: policyApproval + type: object + properties: + catalogEntryId: + type: string + description: The catalog entry ID to approve. + 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: 'The date and time the policy approval is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + lastModifiedDateTime: + 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 date and time the policy approval was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + status: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.approvalStatus' + catalogEntry: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.ring: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: ring + type: object + properties: + 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: 'The date and time when the ring is created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only' + format: date-time + nullable: true + deferralInDays: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The quality update deferral period in days. The value must be between 0 and 30. Optional. + format: int32 + nullable: true + description: + type: string + description: 'The ring description. The maximum length is 1,500 characters. Required' + displayName: + type: string + description: The ring display name. The maximum length is 200 characters. Required. + excludedGroupAssignment: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.excludedGroupAssignment' + includedGroupAssignment: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.includedGroupAssignment' + isPaused: + type: boolean + description: The pause action for the quality update ring policy. Required. + lastModifiedDateTime: + 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 date and time whenthe ring was last modified. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.product: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: product + type: object + properties: + friendlyNames: + type: array + items: + type: string + nullable: true + description: 'The friendly names of the product. For example, Version 22H2 (OS build 22621). Read-only.' + groupName: + type: string + description: 'The name of the product group. For example, Windows 11. Read-only.' + nullable: true + name: + type: string + description: 'The name of the product. For example, Windows 11, version 22H2. Read-only.' + editions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + description: Represents an edition of a particular Windows product. + x-ms-navigationProperty: true + knownIssues: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + description: Represents a known issue related to a Windows product. + x-ms-navigationProperty: true + revisions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' + description: Represents a product revision. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.edition: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: edition + type: object + properties: + deviceFamily: + type: string + description: The device family targeted by the edition. + endOfServiceDateTime: + 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 date and time when the edition reached the end of service. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + generalAvailabilityDateTime: + 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 date and time when the edition became available to the general customers for the first time. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + isInService: + type: boolean + description: Indicates whether the edition is in service or out of service. + name: + type: string + description: The name of the edition. Read-only. + releasedName: + type: string + description: The public name of the edition. Read-only. + servicingPeriods: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.servicingPeriod' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.knownIssue: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: knownIssue + type: object + properties: + description: + type: string + description: The description of the particular known issue. + knownIssueHistories: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssueHistoryItem' + lastUpdatedDateTime: + 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 date and time when the known issue was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + resolvedDateTime: + 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 date and time when the known issue was resolved or mitigated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + safeguardHoldIds: + type: array + items: + maximum: 2147483647 + minimum: -2147483648 + type: number + format: int32 + startDateTime: + 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 date and time when the known issue was first reported. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + status: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.windowsReleaseHealthStatus' + title: + type: string + description: The title of the known issue. + webViewUrl: + type: string + description: The URL to the known issue in the Windows Release Health dashboard on Microsoft 365 admin center. + originatingKnowledgeBaseArticle: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + resolvingKnowledgeBaseArticle: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.knowledgeBaseArticle: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: knowledgeBaseArticle + type: object + properties: + url: + type: string + description: The URL of the knowledge base article. Read-only. + additionalProperties: + type: object + microsoft.graph.windowsUpdates.productRevision: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: productRevision + type: object + properties: + displayName: + type: string + description: The display name of the content. Read-only. + isHotpatchUpdate: + type: boolean + description: 'True indicates that the content is hotpatchable; otherwise, false. For more information, see Deploy a hotpatch quality update using Windows Autopatch. Read-only.' + osBuild: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.buildVersionDetails' + product: + type: string + description: 'The product of the revision. The possible values are: Windows 10, Windows 11. Read-only.' + releaseDateTime: + 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 release date for the content. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + version: + type: string + description: The version of the feature update. Read-only. + catalogEntry: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + knowledgeBaseArticle: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knowledgeBaseArticle' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.resourceConnection: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: resourceConnection + type: object + properties: + state: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnectionState' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.updatePolicy: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: updatePolicy + type: object + properties: + complianceChangeRules: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChangeRule' + description: Rules for governing the automatic creation of compliance changes. + 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: 'The date and time when the update policy was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + deploymentSettings: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentSettings' + audience: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' + complianceChanges: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + description: Compliance changes like content approvals which result in the automatic creation of deployments using the audience and deploymentSettings of the policy. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.complianceChange: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: complianceChange + type: object + properties: + 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: The date and time when a compliance change was created. + format: date-time + nullable: true + isRevoked: + type: boolean + description: 'True indicates that a compliance change is revoked, preventing further application. Revoking a compliance change is a final action.' + nullable: true + revokedDateTime: + 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 date and time when the compliance change was revoked. + format: date-time + nullable: true + updatePolicy: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + additionalProperties: + type: object + microsoft.graph.entity: + title: entity + type: object + properties: + id: + type: string + description: The unique identifier for an entity. Read-only. + additionalProperties: + type: object + microsoft.graph.windowsUpdates.deployableContent: + title: deployableContent + type: object + additionalProperties: + type: object + microsoft.graph.windowsUpdates.deploymentSettings: + title: deploymentSettings + type: object + properties: + contentApplicability: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.contentApplicabilitySettings' + expedite: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.expediteSettings' + monitoring: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.monitoringSettings' + schedule: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.scheduleSettings' + userExperience: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.userExperienceSettings' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.deploymentState: + title: deploymentState + type: object + properties: + effectiveValue: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentStateValue' + reasons: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentStateReason' + description: Specifies the reasons the deployment has its state value. Read-only. + requestedValue: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.requestedDeploymentStateValue' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.approvalRule: + title: approvalRule + type: object + properties: + deferralInDays: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The Windows update deferral period in days. The value must be between 0 and 30. + format: int32 + additionalProperties: + type: object + microsoft.graph.windowsUpdates.approvalStatus: + title: approvalStatus + enum: + - approved + - suspended + - unknownFutureValue + type: string + microsoft.graph.windowsUpdates.excludedGroupAssignment: + allOf: + - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.groupAssignment' + - title: excludedGroupAssignment + type: object + properties: + assignments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.assignedGroup' + description: 'A collection of entities that govern the update deployment audience, defined as a Microsoft Entra group.' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.includedGroupAssignment: + allOf: + - $ref: '#/components/schemas/microsoft.graph.windowsUpdates.groupAssignment' + - title: includedGroupAssignment + type: object + properties: + assignments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.assignedGroup' + description: 'A collection of entities that govern the update deployment audience, defined as a Microsoft Entra group.' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.servicingPeriod: + title: servicingPeriod + type: object + properties: + endDateTime: + 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 date and time when the servicing period ends. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + name: + type: string + description: 'The name of the servicing period. For example, Modern Lifecycle.' + startDateTime: + 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 start date and time of the servicing period. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + additionalProperties: + type: object + microsoft.graph.windowsUpdates.knownIssueHistoryItem: + title: knownIssueHistoryItem + type: object + properties: + body: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.itemBody' + 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: 'The date and time when the post was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + additionalProperties: + type: object + microsoft.graph.windowsUpdates.windowsReleaseHealthStatus: + title: windowsReleaseHealthStatus + enum: + - resolved + - mitigatedExternal + - mitigated + - resolvedExternal + - confirmed + - reported + - investigating + - unknownFutureValue + type: string + microsoft.graph.windowsUpdates.buildVersionDetails: + title: buildVersionDetails + type: object + properties: + buildNumber: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The build number of the product release. Read-only. + format: int32 + majorVersion: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The major version of the product release. Read-only. + format: int32 + minorVersion: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The minor version of the product release. Read-only. + format: int32 + updateBuildRevision: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The update build revision number of the product revision. Read-only. + format: int32 + additionalProperties: + type: object + microsoft.graph.windowsUpdates.resourceConnectionState: + title: resourceConnectionState + enum: + - connected + - notAuthorized + - notFound + - unknownFutureValue + type: string + microsoft.graph.windowsUpdates.complianceChangeRule: + title: complianceChangeRule + type: object + properties: + 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: The date and time when the rule was created. + format: date-time + nullable: true + lastEvaluatedDateTime: + 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 date and time when the rule was last evaluated. + format: date-time + nullable: true + lastModifiedDateTime: + 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 date and time when the rule was last modified. + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.ODataErrors.ODataError: + required: + - error + type: object + properties: + error: + $ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.catalogEntryCollectionResponse: + title: Collection of catalogEntry + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.catalogEntry' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + ODataCountResponse: + type: integer + format: int32 + microsoft.graph.windowsUpdates.deploymentAudienceCollectionResponse: + title: Collection of deploymentAudience + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentAudience' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.applicableContentCollectionResponse: + title: Collection of applicableContent + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContent' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.applicableContentDeviceMatchCollectionResponse: + title: Collection of applicableContentDeviceMatch + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.applicableContentDeviceMatch' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.updatableAssetCollectionResponse: + title: Collection of updatableAsset + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatableAsset' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.deploymentCollectionResponse: + title: Collection of deployment + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deployment' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.policyCollectionResponse: + title: Collection of policy + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policy' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.policyApprovalCollectionResponse: + title: Collection of policyApproval + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.policyApproval' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.ringCollectionResponse: + title: Collection of ring + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.ring' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.productCollectionResponse: + title: Collection of product + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.product' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.editionCollectionResponse: + title: Collection of edition + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.edition' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.knownIssueCollectionResponse: + title: Collection of knownIssue + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.knownIssue' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.productRevisionCollectionResponse: + title: Collection of productRevision + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.productRevision' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.resourceConnectionCollectionResponse: + title: Collection of resourceConnection + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.resourceConnection' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.updatePolicyCollectionResponse: + title: Collection of updatePolicy + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.updatePolicy' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.complianceChangeCollectionResponse: + title: Collection of complianceChange + type: object + properties: + value: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.complianceChange' + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.contentApplicabilitySettings: + title: contentApplicabilitySettings + type: object + properties: + offerWhileRecommendedBy: + type: array + items: + type: string + nullable: true + description: 'Offer if the update is recommended by a vendor in the list, otherwise withhold the offer.' + safeguard: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.safeguardSettings' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.expediteSettings: + title: expediteSettings + type: object + properties: + isExpedited: + type: boolean + description: True indicates that the deployment of the content is expedited. + nullable: true + isReadinessTest: + type: boolean + description: True indicates that the deployment is an expedite readiness test. + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.monitoringSettings: + title: monitoringSettings + type: object + properties: + monitoringRules: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.monitoringRule' + description: Specifies the rules through which monitoring signals can trigger actions on the deployment. Rules are combined using 'or.' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.scheduleSettings: + title: scheduleSettings + type: object + properties: + gradualRollout: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.gradualRolloutSettings' + startDateTime: + 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 date on which devices in the deployment start receiving the update. When not set, the deployment starts as soon as devices are assigned. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.userExperienceSettings: + title: userExperienceSettings + type: object + properties: + daysUntilForcedReboot: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'Specifies the number of days after an update is installed, during which the user of the device can control when the device restarts.' + format: int32 + nullable: true + isHotpatchEnabled: + type: boolean + description: Specifies whether the update is offered as a hotpatch. It can only be set to true on automatic policies that target monthly security updates. + nullable: true + offerAsOptional: + type: boolean + description: Specifies whether the update is offered as Optional rather than Required. + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.deploymentStateValue: + title: deploymentStateValue + enum: + - scheduled + - offering + - paused + - faulted + - archived + - unknownFutureValue + type: string + microsoft.graph.windowsUpdates.deploymentStateReason: + title: deploymentStateReason + type: object + properties: + value: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.deploymentStateReasonValue' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.requestedDeploymentStateValue: + title: requestedDeploymentStateValue + enum: + - none + - paused + - archived + - unknownFutureValue + type: string + microsoft.graph.windowsUpdates.groupAssignment: + title: groupAssignment + type: object + additionalProperties: + type: object + microsoft.graph.windowsUpdates.assignedGroup: + title: assignedGroup + type: object + properties: + groupId: + type: string + description: 'The unique identifier for the group. Returned by default. Key. Not nullable. Read-only. Supports $filter (eq, ne, not, in).' + group: + $ref: '#/components/schemas/microsoft.graph.group' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.itemBody: + title: itemBody + type: object + properties: + content: + type: string + description: The content of the item. + nullable: true + contentType: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.bodyType' + additionalProperties: + type: object + microsoft.graph.ODataErrors.MainError: + required: + - code + - message + type: object + properties: + code: + type: string + message: + type: string + x-ms-primary-error-message: true + target: + type: string + nullable: true + details: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails' + innerError: + $ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.safeguardSettings: + title: safeguardSettings + type: object + properties: + disabledSafeguardProfiles: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.safeguardProfile' + description: List of safeguards to ignore per device. + additionalProperties: + type: object + microsoft.graph.windowsUpdates.monitoringRule: + title: monitoringRule + type: object + properties: + action: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.monitoringAction' + signal: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.monitoringSignal' + threshold: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The threshold for a signal at which to trigger the action. An integer from 1 to 100 (inclusive). This value is ignored when the signal is ineligible and the action is offerFallback. + format: int32 + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.gradualRolloutSettings: + title: gradualRolloutSettings + type: object + properties: + durationBetweenOffers: + pattern: '^-?P([0-9]+D)?(T([0-9]+H)?([0-9]+M)?([0-9]+([.][0-9]+)?S)?)?$' + type: string + description: The duration between each set of devices being offered the update. The value is represented in ISO 8601 format for duration. Default value is P1D (one day). + format: duration + nullable: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.deploymentStateReasonValue: + title: deploymentStateReasonValue + enum: + - scheduledByOfferWindow + - offeringByRequest + - pausedByRequest + - pausedByMonitoring + - unknownFutureValue + - faultedByContentOutdated + type: string + microsoft.graph.group: + allOf: + - $ref: '#/components/schemas/microsoft.graph.directoryObject' + - title: group + type: object + properties: + accessType: + $ref: '#/components/schemas/microsoft.graph.groupAccessType' + allowExternalSenders: + type: boolean + description: 'Indicates if people external to the organization can send messages to the group. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).' + nullable: true + assignedLabels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.assignedLabel' + description: 'The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. Requires $select to retrieve. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and a supported administrator role.' + assignedLicenses: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.assignedLicense' + description: The licenses that are assigned to the group. Requires $select to retrieve. Supports $filter (eq). Read-only. + autoSubscribeNewMembers: + type: boolean + description: 'Indicates if new members added to the group are auto-subscribed to receive email notifications. You can set this property in a PATCH request for the group; don''t set it in the initial POST request that creates the group. Default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).' + nullable: true + classification: + type: string + description: 'Describes a classification for the group (such as low, medium or high business impact). Valid values for this property are defined by creating a ClassificationList setting value, based on the template definition.Returned by default. Supports $filter (eq, ne, not, ge, le, startsWith).' + nullable: true + cloudLicensing: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.groupCloudLicensing' + createdByAppId: + type: string + description: 'App ID of the app used to create the group. Can be null for some groups. Returned by default. Read-only. Supports $filter (eq, ne, not, in, startsWith).' + 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: 'Timestamp of when the group was created. The value can''t be modified and is automatically populated when the group is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned by default. Read-only.' + format: date-time + nullable: true + description: + type: string + description: 'An optional description for the group. Returned by default. Supports $filter (eq, ne, not, ge, le, startsWith) and $search.' + nullable: true + displayName: + type: string + description: 'The display name for the group. Required. Maximum length is 256 characters. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values), $search, and $orderby.' + nullable: true + expirationDateTime: + 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: 'Timestamp of when the group is set to expire. It is null for security groups, but for Microsoft 365 groups, it represents when the group is set to expire as defined in the groupLifecyclePolicy. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned by default. Supports $filter (eq, ne, not, ge, le, in). Read-only.' + format: date-time + nullable: true + groupTypes: + type: array + items: + type: string + description: 'Specifies the group type and its membership. If the collection contains Unified, the group is a Microsoft 365 group; otherwise, it''s either a security group or a distribution group. For details, see groups overview.If the collection includes DynamicMembership, the group has dynamic membership; otherwise, membership is static. Returned by default. Supports $filter (eq, not).' + hasMembersWithLicenseErrors: + type: boolean + description: 'Indicates whether there are members in this group that have license errors from its group-based license assignment. This property is never returned on a GET operation. You can use it as a $filter argument to get groups that have members with license errors (that is, filter for this property being true). Supports $filter (eq).' + nullable: true + hideFromAddressLists: + type: boolean + description: 'true if the group isn''t displayed in certain parts of the Outlook user interface: in the Address Book, in address lists for selecting message recipients, and in the Browse Groups dialog for searching groups; false otherwise. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).' + nullable: true + hideFromOutlookClients: + type: boolean + description: 'true if the group isn''t displayed in Outlook clients, such as Outlook for Windows and Outlook on the web, false otherwise. The default value is false. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).' + nullable: true + infoCatalogs: + type: array + items: + type: string + description: 'Identifies the info segments assigned to the group. Returned by default. Supports $filter (eq, not, ge, le, startsWith).' + isArchived: + type: boolean + description: 'When a group is associated with a team, this property determines whether the team is in read-only mode. To read this property, use the /group/{groupId}/team endpoint or the Get team API. To update this property, use the archiveTeam and unarchiveTeam APIs.' + nullable: true + isAssignableToRole: + type: boolean + description: 'Indicates whether this group can be assigned to a Microsoft Entra role. Optional. This property can only be set while creating the group and is immutable. If set to true, the securityEnabled property must also be set to true, visibility must be Hidden, and the group cannot be a dynamic group (that is, groupTypes can''t contain DynamicMembership). Only callers with at least the Privileged Role Administrator role can set this property. The caller must also be assigned the RoleManagement.ReadWrite.Directory permission to set this property or update the membership of such groups. For more, see Using a group to manage Microsoft Entra role assignmentsUsing this feature requires a Microsoft Entra ID P1 license. Returned by default. Supports $filter (eq, ne, not).' + nullable: true + isFavorite: + type: boolean + description: Indicates whether the user marked the group as favorite. + nullable: true + isManagementRestricted: + type: boolean + description: 'Indicates whether the group is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a group member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit.' + nullable: true + isSubscribedByMail: + type: boolean + description: 'Indicates whether the signed-in user is subscribed to receive email conversations. The default value is true. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).' + nullable: true + licenseProcessingState: + $ref: '#/components/schemas/microsoft.graph.licenseProcessingState' + mail: + type: string + description: 'The SMTP address for the group, for example, ''serviceadmins@contoso.com''. Returned by default. Read-only. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + mailEnabled: + type: boolean + description: 'Specifies whether the group is mail-enabled. Required. Returned by default. Supports $filter (eq, ne, not, and eq on null values).' + nullable: true + mailNickname: + type: string + description: 'The mail alias for the group, unique for Microsoft 365 groups in the organization. Maximum length is 64 characters. This property can contain only characters in the ASCII character set 0 - 127 except the following: @ () / [] '' ; : <> , SPACE. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith).' + nullable: true + membershipRule: + type: string + description: 'The rule that determines members for this group if the group is a dynamic group (groupTypes contains DynamicMembership). For more information about the syntax of the membership rule, see Membership Rules syntax. Returned by default. Supports $filter (eq, ne, not, ge, le, startsWith).' + nullable: true + membershipRuleProcessingState: + type: string + description: 'Indicates whether the dynamic membership processing is on or paused. Possible values are On or Paused. Returned by default. Supports $filter (eq, ne, not, in).' + nullable: true + membershipRuleProcessingStatus: + $ref: '#/components/schemas/microsoft.graph.membershipRuleProcessingStatus' + onPremisesDomainName: + type: string + description: 'Contains the on-premises domain FQDN, also called dnsDomainName synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only.' + nullable: true + onPremisesExtensionAttributes: + $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes' + onPremisesLastSyncDateTime: + 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: 'Indicates the last time at which the group was synced with the on-premises directory.The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned by default. Read-only. Supports $filter (eq, ne, not, ge, le, in).' + format: date-time + nullable: true + onPremisesNetBiosName: + type: string + description: Contains the on-premises netBios name synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Read-only. + nullable: true + onPremisesProvisioningErrors: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onPremisesProvisioningError' + description: 'Errors when using Microsoft synchronization product during provisioning. Returned by default. Supports $filter (eq, not).' + onPremisesSamAccountName: + type: string + description: 'Contains the on-premises SAM account name synchronized from the on-premises directory. The property is only populated for customers synchronizing their on-premises directory to Microsoft Entra ID via Microsoft Entra Connect.Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith). Read-only.' + nullable: true + onPremisesSecurityIdentifier: + type: string + description: Contains the on-premises security identifier (SID) for the group synchronized from on-premises to the cloud. Read-only. Returned by default. Supports $filter (eq including on null values). + nullable: true + onPremisesSyncEnabled: + type: boolean + description: 'true if this group is synced from an on-premises directory; false if this group was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default). Returned by default. Read-only. Supports $filter (eq, ne, not, in, and eq on null values).' + nullable: true + organizationId: + type: string + nullable: true + preferredDataLocation: + type: string + description: 'The preferred data location for the Microsoft 365 group. By default, the group inherits the group creator''s preferred data location. To set this property, the calling app must be granted the Directory.ReadWrite.All permission and the user be assigned at least one of the following Microsoft Entra roles: User Account Administrator Directory Writer Exchange Administrator SharePoint Administrator For more information about this property, see OneDrive Online Multi-Geo and Create a Microsoft 365 group with a specific PDL. Nullable. Returned by default.' + nullable: true + preferredLanguage: + type: string + description: 'The preferred language for a Microsoft 365 group. Should follow ISO 639-1 Code; for example, en-US. Returned by default. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + proxyAddresses: + type: array + items: + type: string + description: 'Email addresses for the group that direct to the same group mailbox. For example: [''SMTP: bob@contoso.com'', ''smtp: bob@sales.contoso.com'']. The any operator is required for filter expressions on multi-valued properties. Returned by default. Read-only. Not nullable. Supports $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).' + renewedDateTime: + 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: 'Timestamp of when the group was last renewed. This cannot be modified directly and is only updated via the renew service action. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned by default. Supports $filter (eq, ne, not, ge, le, in). Read-only.' + format: date-time + nullable: true + resourceBehaviorOptions: + type: array + items: + type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' + resourceProvisioningOptions: + type: array + items: + type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith.' + securityEnabled: + type: boolean + description: 'Specifies whether the group is a security group. Required.Returned by default. Supports $filter (eq, ne, not, in).' + nullable: true + securityIdentifier: + type: string + description: 'Security identifier of the group, used in Windows scenarios. Read-only. Returned by default.' + nullable: true + serviceProvisioningErrors: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.serviceProvisioningError' + description: 'Errors published by a federated service describing a non-transient, service-specific error regarding the properties or link from a group object.' + theme: + type: string + description: 'Specifies a Microsoft 365 group''s color theme. Possible values are Teal, Purple, Green, Blue, Pink, Orange or Red. Returned by default.' + nullable: true + uniqueName: + type: string + description: The unique identifier that can be assigned to a group and used as an alternate key. Immutable. Read-only. + nullable: true + unseenConversationsCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Count of conversations delivered one or more new posts since the signed-in user's last visit to the group. This property is the same as unseenCount. Requires $select to retrieve. + format: int32 + nullable: true + unseenCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'Count of conversations that have received new posts since the signed-in user last visited the group. This property is the same as unseenConversationsCount.Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).' + format: int32 + nullable: true + unseenMessagesCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Count of new posts that have been delivered to the group's conversations since the signed-in user's last visit to the group. Requires $select to retrieve. + format: int32 + nullable: true + visibility: + type: string + description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' + nullable: true + welcomeMessageEnabled: + type: boolean + description: 'Indicates whether a welcome message is sent to new members when they are added to the group. The default value is true. Requires $select to retrieve. Supported only on the Get group API (GET /groups/{ID}).' + nullable: true + writebackConfiguration: + $ref: '#/components/schemas/microsoft.graph.groupWritebackConfiguration' + acceptedSenders: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'The list of users or groups allowed to create posts or calendar events in this group. If this list is non-empty, then only users or groups listed here can post.' + x-ms-navigationProperty: true + appRoleAssignments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.appRoleAssignment' + description: Represents the app roles a group has been granted for an application. Supports $expand. + x-ms-navigationProperty: true + calendar: + $ref: '#/components/schemas/microsoft.graph.calendar' + calendarView: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: The calendar view for the calendar. Read-only. + x-ms-navigationProperty: true + conversations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.conversation' + description: The group's conversations. + x-ms-navigationProperty: true + createdOnBehalfOf: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + drive: + $ref: '#/components/schemas/microsoft.graph.drive' + drives: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.drive' + description: The group's drives. Read-only. + x-ms-navigationProperty: true + endpoints: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.endpoint' + description: Endpoints for the group. Read-only. Nullable. + x-ms-navigationProperty: true + events: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: The group's events. + x-ms-navigationProperty: true + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the group. Read-only. Nullable. + x-ms-navigationProperty: true + groupLifecyclePolicies: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.groupLifecyclePolicy' + description: The collection of lifecycle policies for this group. Read-only. Nullable. + x-ms-navigationProperty: true + memberOf: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'Groups and administrative units that this group is a member of. HTTP Methods: GET (supported for all groups). Read-only. Nullable. Supports $expand.' + x-ms-navigationProperty: true + members: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'Direct group members, who can be users, devices, other groups, or service principals. Supports the List members, Add member, and Remove member operations. Nullable. Supports $expand including nested $select. For example, /groups?$filter=startsWith(displayName,''Role'')&$select=id,displayName&$expand=members($select=id,userPrincipalName,displayName).' + x-ms-navigationProperty: true + membersWithLicenseErrors: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: A list of group members with license errors from this group-based license assignment. Read-only. + x-ms-navigationProperty: true + onenote: + $ref: '#/components/schemas/microsoft.graph.onenote' + onPremisesSyncBehavior: + $ref: '#/components/schemas/microsoft.graph.onPremisesSyncBehavior' + owners: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'The owners of the group who can be users or service principals. Limited to 100 owners. Nullable. If this property isn''t specified when creating a Microsoft 365 group the calling user (admin or non-admin) is automatically assigned as the group owner. A non-admin user can''t explicitly add themselves to this collection when they''re creating the group. For more information, see the related known issue. For security groups, the admin user isn''t automatically added to this collection. For more information, see the related known issue. Supports $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1); Supports $expand including nested $select. For example, /groups?$filter=startsWith(displayName,''Role'')&$select=id,displayName&$expand=owners($select=id,userPrincipalName,displayName).' + x-ms-navigationProperty: true + permissionGrants: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.resourceSpecificPermissionGrant' + description: The permissions granted for a group to a specific application. Supports $expand. + x-ms-navigationProperty: true + photo: + $ref: '#/components/schemas/microsoft.graph.profilePhoto' + photos: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.profilePhoto' + description: The profile photos owned by the group. Read-only. Nullable. + x-ms-navigationProperty: true + planner: + $ref: '#/components/schemas/microsoft.graph.plannerGroup' + rejectedSenders: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: The list of users or groups not allowed to create posts or calendar events in this group. Nullable + x-ms-navigationProperty: true + settings: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directorySetting' + description: 'Settings that can govern this group''s behavior, like whether members can invite guest users to the group. Nullable.' + x-ms-navigationProperty: true + sites: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.site' + description: The list of SharePoint sites in this group. Access the default site with /sites/root. + x-ms-navigationProperty: true + team: + $ref: '#/components/schemas/microsoft.graph.team' + threads: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.conversationThread' + description: The group's conversation threads. Nullable. + x-ms-navigationProperty: true + transitiveMemberOf: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'The groups a group is a member of, either directly or through nested membership. Nullable.' + x-ms-navigationProperty: true + transitiveMembers: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: The direct and transitive members of a group. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + description: Represents a Microsoft Entra group. + microsoft.graph.windowsUpdates.bodyType: + title: bodyType + enum: + - text + - html + - unknownFutureValue + type: string + microsoft.graph.ODataErrors.ErrorDetails: + required: + - code + - message + type: object + properties: + code: + type: string + message: + type: string + target: + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.ODataErrors.InnerError: + type: object + additionalProperties: + type: object + description: The structure of this object is service-specific + microsoft.graph.windowsUpdates.safeguardProfile: + title: safeguardProfile + type: object + properties: + category: + $ref: '#/components/schemas/microsoft.graph.windowsUpdates.safeguardCategory' + additionalProperties: + type: object + microsoft.graph.windowsUpdates.monitoringAction: + title: monitoringAction + enum: + - alertError + - offerFallback + - pauseDeployment + - unknownFutureValue + type: string + microsoft.graph.windowsUpdates.monitoringSignal: + title: monitoringSignal + enum: + - rollback + - ineligible + - unknownFutureValue + type: string + microsoft.graph.directoryObject: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: directoryObject + type: object + properties: + deletedDateTime: + 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 when this object was deleted. Always null when the object hasn't been deleted. + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.groupAccessType: + title: groupAccessType + enum: + - none + - private + - secret + - public + type: string + microsoft.graph.assignedLabel: + title: assignedLabel + type: object + properties: + displayName: + type: string + description: The display name of the label. Read-only. + nullable: true + labelId: + type: string + description: The unique identifier of the label. + nullable: true + additionalProperties: + type: object + microsoft.graph.assignedLicense: + title: assignedLicense + type: object + properties: + disabledPlans: + type: array + items: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + format: uuid + description: A collection of the unique identifiers for plans that have been disabled. IDs are available in servicePlans > servicePlanId in the tenant's subscribedSkus or serviceStatus > servicePlanId in the tenant's companySubscription. + skuId: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + description: The unique identifier for the SKU. Corresponds to the skuId from subscribedSkus or companySubscription. + format: uuid + nullable: true + additionalProperties: + type: object + microsoft.graph.cloudLicensing.groupCloudLicensing: + title: groupCloudLicensing + type: object + properties: + assignments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.assignment' + x-ms-navigationProperty: true + usageRights: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.usageRight' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.licenseProcessingState: + title: licenseProcessingState + type: object + properties: + state: + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.membershipRuleProcessingStatus: + title: membershipRuleProcessingStatus + type: object + properties: + errorMessage: + type: string + description: Detailed error message if dynamic group processing ran into an error. Optional. Read-only. + nullable: true + lastMembershipUpdated: + 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: Most recent date and time when membership of a dynamic group was updated. Optional. Read-only. + format: date-time + nullable: true + status: + $ref: '#/components/schemas/microsoft.graph.MembershipRuleProcessingStatusDetails' + additionalProperties: + type: object + microsoft.graph.onPremisesExtensionAttributes: + title: onPremisesExtensionAttributes + 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. + nullable: true + extensionAttribute3: + type: string + description: Third customizable extension attribute. + nullable: true + extensionAttribute4: + type: string + description: Fourth customizable extension attribute. + nullable: true + extensionAttribute5: + type: string + description: Fifth customizable extension attribute. + nullable: true + extensionAttribute6: + type: string + description: Sixth customizable extension attribute. + nullable: true + extensionAttribute7: + type: string + description: Seventh customizable extension attribute. + nullable: true + extensionAttribute8: + type: string + description: Eighth customizable extension attribute. + nullable: true + extensionAttribute9: + type: string + description: Ninth customizable extension attribute. + nullable: true + additionalProperties: + type: object + microsoft.graph.onPremisesProvisioningError: + title: onPremisesProvisioningError + type: object + properties: + category: + type: string + description: 'Category of the provisioning error. Note: Currently, there is only one possible value. Possible value: PropertyConflict - indicates a property value is not unique. Other objects contain the same value for the property.' + nullable: true + occurredDateTime: + 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 date and time at which the error occurred. + format: date-time + nullable: true + propertyCausingError: + type: string + description: 'Name of the directory property causing the error. Current possible values: UserPrincipalName or ProxyAddress' + nullable: true + value: + type: string + description: Value of the property causing the error. + nullable: true + additionalProperties: + type: object + microsoft.graph.serviceProvisioningError: + title: serviceProvisioningError + type: object + properties: + 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: The date and time at which the error occurred. + format: date-time + nullable: true + isResolved: + type: boolean + description: Indicates whether the Error has been attended to. + nullable: true + serviceInstance: + type: string + description: 'Qualified service instance (for example, ''SharePoint/Dublin'') that published the service error information.' + nullable: true + additionalProperties: + type: object + microsoft.graph.groupWritebackConfiguration: + allOf: + - $ref: '#/components/schemas/microsoft.graph.writebackConfiguration' + - title: groupWritebackConfiguration + type: object + properties: + onPremisesGroupType: + type: string + description: 'Indicates the target on-premises group type the cloud object is written back as. Nullable. The possible values are: universalDistributionGroup, universalSecurityGroup, universalMailEnabledSecurityGroup.If the cloud group is a unified (Microsoft 365) group, this property can be one of the following: universalDistributionGroup, universalSecurityGroup, universalMailEnabledSecurityGroup. Microsoft Entra security groups can be written back as universalSecurityGroup. If isEnabled or the NewUnifiedGroupWritebackDefault group setting is true but this property isn''t explicitly configured: Microsoft 365 groups are written back as universalDistributionGroup by defaultSecurity groups are written back as universalSecurityGroup by default' + nullable: true + additionalProperties: + type: object + microsoft.graph.appRoleAssignment: + allOf: + - $ref: '#/components/schemas/microsoft.graph.directoryObject' + - title: appRoleAssignment + type: object + properties: + appRoleId: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + description: 'The identifier (id) for the app role that is assigned to the principal. This app role must be exposed in the appRoles property on the resource application''s service principal (resourceId). If the resource application hasn''t declared any app roles, a default app role ID of 00000000-0000-0000-0000-000000000000 can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create.' + format: uuid + creationTimestamp: + 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 time when the app role assignment was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + principalDisplayName: + type: string + description: 'The display name of the user, group, or service principal that was granted the app role assignment. Maximum length is 256 characters. Read-only. Supports $filter (eq and startswith).' + nullable: true + principalId: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + description: 'The unique identifier (id) for the user, security group, or service principal being granted the app role. Security groups with dynamic memberships are supported. Required on create.' + format: uuid + nullable: true + principalType: + type: string + description: 'The type of the assigned principal. This can either be User, Group, or ServicePrincipal. Read-only.' + nullable: true + resourceDisplayName: + type: string + description: The display name of the resource app's service principal to which the assignment is made. Maximum length is 256 characters. + nullable: true + resourceId: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + description: The unique identifier (id) for the resource service principal for which the assignment is made. Required on create. Supports $filter (eq only). + format: uuid + nullable: true + additionalProperties: + type: object + microsoft.graph.calendar: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: calendar + type: object + properties: + allowedOnlineMeetingProviders: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType' + description: 'Represent the online meeting service providers that can be used to create online meetings in this calendar. The possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.' + calendarGroupId: + type: string + description: 'The calendarGroup in which to create the calendar. If the user has never explicitly set a group for the calendar, this property is null.' + nullable: true + canEdit: + type: boolean + description: 'true if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who has been shared a calendar and granted write access, through an Outlook client or the corresponding calendarPermission resource. Read-only.' + nullable: true + canShare: + type: boolean + description: 'true if the user has the permission to share the calendar, false otherwise. Only the user who created the calendar can share it. Read-only.' + nullable: true + canViewPrivateItems: + type: boolean + description: 'true if the user can read calendar items that have been marked private, false otherwise. This property is set through an Outlook client or the corresponding calendarPermission resource. Read-only.' + nullable: true + changeKey: + type: string + description: 'Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' + nullable: true + color: + $ref: '#/components/schemas/microsoft.graph.calendarColor' + defaultOnlineMeetingProvider: + $ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType' + hexColor: + type: string + description: 'The calendar color, expressed in a hex color code of three hexadecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is empty.' + nullable: true + isDefaultCalendar: + type: boolean + description: 'true if this is the default calendar where new events are created by default, false otherwise.' + nullable: true + isRemovable: + type: boolean + description: Indicates whether this user calendar can be deleted from the user mailbox. + nullable: true + isShared: + type: boolean + description: 'true if the user has shared the calendar with other users, false otherwise. Since only the user who created the calendar can share it, isShared and isSharedWithMe cannot be true for the same user. This property is set when sharing is initiated in an Outlook client, and can be reset when the sharing is cancelled through the client or the corresponding calendarPermission resource. Read-only.' + nullable: true + isSharedWithMe: + type: boolean + description: 'true if the user has been shared this calendar, false otherwise. This property is always false for a calendar owner. This property is set when sharing is initiated in an Outlook client, and can be reset when the sharing is cancelled through the client or the corresponding calendarPermission resource. Read-only.' + nullable: true + isTallyingResponses: + type: boolean + description: Indicates whether this user calendar supports tracking of meeting responses. Only meeting invites sent from users' primary calendars support tracking of meeting responses. + nullable: true + name: + type: string + description: The calendar name. + nullable: true + owner: + $ref: '#/components/schemas/microsoft.graph.emailAddress' + calendarPermissions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.calendarPermission' + description: The permissions of the users with whom the calendar is shared. + x-ms-navigationProperty: true + calendarView: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: The calendar view for the calendar. Navigation property. Read-only. + x-ms-navigationProperty: true + events: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: The events in the calendar. Navigation property. Read-only. + x-ms-navigationProperty: true + multiValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' + description: The collection of multi-value extended properties defined for the calendar. Read-only. Nullable. + x-ms-navigationProperty: true + singleValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' + description: The collection of single-value extended properties defined for the calendar. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.event: + allOf: + - $ref: '#/components/schemas/microsoft.graph.outlookItem' + - title: event + type: object + properties: + allowNewTimeProposals: + type: boolean + description: true if the meeting organizer allows invitees to propose a new time when responding; otherwise false. Optional. Default is true. + nullable: true + attendees: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.attendee' + description: The collection of attendees for the event. + body: + $ref: '#/components/schemas/microsoft.graph.itemBody' + bodyPreview: + type: string + description: The preview of the message associated with the event. It is in text format. + nullable: true + cancelledOccurrences: + type: array + items: + type: string + nullable: true + description: 'Contains occurrenceId property values of canceled instances in a recurring series, if the event is the series master. Instances in a recurring series that are canceled are called cancelledOccurences.Returned only on $select in a Get operation which specifies the id of a series master event (that is, the seriesMasterId property value).' + end: + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + hasAttachments: + type: boolean + description: Set to true if the event has attachments. + nullable: true + hideAttendees: + type: boolean + description: 'When set to true, each attendee only sees themselves in the meeting request and meeting Tracking list. Default is false.' + nullable: true + iCalUId: + type: string + description: A unique identifier for an event across calendars. This ID is different for each occurrence in a recurring series. Read-only. + nullable: true + importance: + $ref: '#/components/schemas/microsoft.graph.importance' + isAllDay: + type: boolean + description: 'Set to true if the event lasts all day. If true, regardless of whether it''s a single-day or multi-day event, start and end time must be set to midnight and be in the same time zone.' + nullable: true + isCancelled: + type: boolean + description: Set to true if the event has been canceled. + nullable: true + isDraft: + type: boolean + description: 'Set to true if the user has updated the meeting in Outlook but hasn''t sent the updates to attendees. Set to false if all changes have been sent, or if the event is an appointment without any attendees.' + nullable: true + isOnlineMeeting: + type: boolean + description: 'True if this event has online meeting information (that is, onlineMeeting points to an onlineMeetingInfo resource), false otherwise. Default is false (onlineMeeting is null). Optional. After you set isOnlineMeeting to true, Microsoft Graph initializes onlineMeeting. Outlook then ignores any further changes to isOnlineMeeting, and the meeting remains available online.' + nullable: true + isOrganizer: + type: boolean + description: Set to true if the calendar owner (specified by the owner property of the calendar) is the organizer of the event (specified by the organizer property of the event). This also applies if a delegate organized the event on behalf of the owner. + nullable: true + isReminderOn: + type: boolean + description: Set to true if an alert is set to remind the user of the event. + nullable: true + location: + $ref: '#/components/schemas/microsoft.graph.location' + locations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.location' + description: 'The locations where the event is held or attended from. The location and locations properties always correspond with each other. If you update the location property, any prior locations in the locations collection would be removed and replaced by the new location value.' + occurrenceId: + type: string + description: 'An identifier for an occurrence in a recurring event series. Null if the event isn''t part of a recurring series.The format of the property value is OID.{seriesMasterId-value}.{occurrence-start-date}. The time zone for {occurrence-start-date} is the recurrenceTimeZone property defined for the corresponding recurrenceRange.This property can identify any occurrence in a recurring series, including an occurrence that has been modified or canceled. You can use this property to perform all operations supported by occurrences in the recurring series.' + nullable: true + onlineMeeting: + $ref: '#/components/schemas/microsoft.graph.onlineMeetingInfo' + onlineMeetingProvider: + $ref: '#/components/schemas/microsoft.graph.onlineMeetingProviderType' + onlineMeetingUrl: + type: string + description: 'A URL for an online meeting. The property is set only when an organizer specifies in Outlook that an event is an online meeting such as Skype. Read-only.To access the URL to join an online meeting, use joinUrl which is exposed via the onlineMeeting property of the event. The onlineMeetingUrl property will be deprecated in the future.' + nullable: true + organizer: + $ref: '#/components/schemas/microsoft.graph.recipient' + originalEndTimeZone: + type: string + description: The end time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook. + nullable: true + originalStart: + 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: 'Represents the start time of an event when it''s initially created as an occurrence or exception in a recurring series. This property isn''t returned for events that are single instances. Its date and time information is expressed in ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + originalStartTimeZone: + type: string + description: The start time zone that was set when the event was created. A value of tzone://Microsoft/Custom indicates that a legacy custom time zone was set in desktop Outlook. + nullable: true + recurrence: + $ref: '#/components/schemas/microsoft.graph.patternedRecurrence' + reminderMinutesBeforeStart: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of minutes before the event start time that the reminder alert occurs. + format: int32 + nullable: true + responseRequested: + type: boolean + description: 'Default is true, which represents the organizer would like an invitee to send a response to the event.' + nullable: true + responseStatus: + $ref: '#/components/schemas/microsoft.graph.responseStatus' + sensitivity: + $ref: '#/components/schemas/microsoft.graph.sensitivity' + seriesMasterId: + type: string + description: 'The ID for the recurring series master item, if this event is part of a recurring series.' + nullable: true + showAs: + $ref: '#/components/schemas/microsoft.graph.freeBusyStatus' + start: + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + subject: + type: string + description: The text of the event's subject line. + nullable: true + transactionId: + type: string + description: 'A custom identifier specified by a client app for the server to avoid redundant POST operations if the client retries to create the same event. This is useful when low network connectivity causes the client to time out before receiving a response from the server for the client''s prior create-event request. After you set transactionId when creating an event, you can''t change transactionId in a subsequent update. This property is only returned in a response payload if an app has set it. Optional.' + nullable: true + type: + $ref: '#/components/schemas/microsoft.graph.eventType' + uid: + type: string + description: 'A unique identifier for calendar events. For recurring events, the value is the same for the series master and all of its occurrences including exceptions.' + nullable: true + webLink: + type: string + description: 'The URL to open the event in Outlook on the web.Outlook on the web opens the event in the browser if you''re signed in to your mailbox. Otherwise, Outlook on the web prompts you to sign in.This URL can''t be accessed from within an iFrame.' + nullable: true + attachments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.attachment' + description: 'The collection of FileAttachment, ItemAttachment, and referenceAttachment attachments for the event. Navigation property. Read-only. Nullable.' + x-ms-navigationProperty: true + calendar: + $ref: '#/components/schemas/microsoft.graph.calendar' + exceptionOccurrences: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + x-ms-navigationProperty: true + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the event. Nullable. + x-ms-navigationProperty: true + instances: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: 'The occurrences of a recurring series, if the event is a series master. This property includes occurrences that are part of the recurrence pattern and exceptions that have been modified. It doesn''t include occurrences that have been canceled from the series. Navigation property. Read-only. Nullable.' + x-ms-navigationProperty: true + multiValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' + description: The collection of multi-value extended properties defined for the event. Read-only. Nullable. + x-ms-navigationProperty: true + singleValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' + description: The collection of single-value extended properties defined for the event. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.conversation: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: conversation + type: object + properties: + hasAttachments: + type: boolean + description: 'Indicates whether any of the posts within this Conversation has at least one attachment. Supports $filter (eq, ne) and $search.' + lastDeliveredDateTime: + 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 Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Supports $filter (eq, ne, le, ge).' + format: date-time + preview: + type: string + description: A short summary from the body of the latest post in this conversation. + topic: + type: string + description: 'The topic of the conversation. This property can be set when the conversation is created, but it can''t be updated.' + uniqueSenders: + type: array + items: + type: string + description: All the users that sent a message to this Conversation. + threads: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.conversationThread' + description: A collection of all the conversation threads in the conversation. A navigation property. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.drive: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItem' + - title: drive + type: object + properties: + driveType: + type: string + description: Describes the type of drive represented by this resource. OneDrive personal drives return personal. OneDrive for Business returns business. SharePoint document libraries return documentLibrary. Read-only. + nullable: true + owner: + $ref: '#/components/schemas/microsoft.graph.identitySet' + quota: + $ref: '#/components/schemas/microsoft.graph.quota' + sharePointIds: + $ref: '#/components/schemas/microsoft.graph.sharepointIds' + system: + $ref: '#/components/schemas/microsoft.graph.systemFacet' + activities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.itemActivityOLD' + description: The list of recent activities that took place under this drive. + x-ms-navigationProperty: true + bundles: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.driveItem' + description: Collection of bundles (albums and multi-select-shared sets of items). Only in personal OneDrive. + x-ms-navigationProperty: true + following: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.driveItem' + description: The list of items the user is following. Only in OneDrive for Business. + x-ms-navigationProperty: true + items: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.driveItem' + description: All items contained in the drive. Read-only. Nullable. + x-ms-navigationProperty: true + list: + $ref: '#/components/schemas/microsoft.graph.list' + root: + $ref: '#/components/schemas/microsoft.graph.driveItem' + special: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.driveItem' + description: Collection of common folders available in OneDrive. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.endpoint: + allOf: + - $ref: '#/components/schemas/microsoft.graph.directoryObject' + - title: endpoint + type: object + properties: + capability: + type: string + description: 'Describes the capability that is associated with this resource. (for example, Messages, Conversations, etc.) Not nullable. Read-only.' + providerId: + type: string + description: Application id of the publishing underlying service. Not nullable. Read-only. + nullable: true + providerName: + type: string + description: Name of the publishing underlying service. Read-only. + nullable: true + providerResourceId: + type: string + description: 'For Microsoft 365 groups, this is set to a well-known name for the resource (for example, Yammer.FeedURL etc.). Not nullable. Read-only.' + nullable: true + uri: + type: string + description: URL of the published resource. Not nullable. Read-only. + additionalProperties: + type: object + microsoft.graph.extension: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: extension + type: object + additionalProperties: + type: object + microsoft.graph.groupLifecyclePolicy: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: groupLifecyclePolicy + type: object + properties: + alternateNotificationEmails: + type: string + description: List of email address to send notifications for groups without owners. Multiple email address can be defined by separating email address with a semicolon. + nullable: true + groupLifetimeInDays: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'Number of days before a group expires and needs to be renewed. Once renewed, the group expiration is extended by the number of days defined.' + format: int32 + nullable: true + managedGroupTypes: + type: string + description: 'The group type for which the expiration policy applies. Possible values are All, Selected or None.' + nullable: true + additionalProperties: + type: object + microsoft.graph.onenote: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: onenote + type: object + properties: + notebooks: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.notebook' + description: The collection of OneNote notebooks that the user or group owns. Read-only. Nullable. + x-ms-navigationProperty: true + operations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onenoteOperation' + description: 'The status of OneNote operations. Getting an operations collection isn''t supported, but you can get the status of long-running operations if the Operation-Location header is returned in the response. Read-only. Nullable.' + x-ms-navigationProperty: true + pages: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onenotePage' + description: The pages in all OneNote notebooks that the user or group owns. Read-only. Nullable. + x-ms-navigationProperty: true + resources: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onenoteResource' + description: 'The image and other file resources in OneNote pages. Getting a resources collection isn''t supported, but you can get the binary content of a specific resource. Read-only. Nullable.' + x-ms-navigationProperty: true + sectionGroups: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.sectionGroup' + description: The section groups in all OneNote notebooks that the user or group owns. Read-only. Nullable. + x-ms-navigationProperty: true + sections: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onenoteSection' + description: The sections in all OneNote notebooks that the user or group owns. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.onPremisesSyncBehavior: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: onPremisesSyncBehavior + type: object + properties: + isCloudManaged: + type: boolean + description: 'Indicates the state of synchronization for an object between the cloud and on-premises Active Directory. If true, updates from on-premises Active Directory are blocked in the cloud; if false, updates from on-premises Active Directory are allowed in the cloud and the on-premises Active Directory can take over the object.' + additionalProperties: + type: object + microsoft.graph.resourceSpecificPermissionGrant: + allOf: + - $ref: '#/components/schemas/microsoft.graph.directoryObject' + - title: resourceSpecificPermissionGrant + type: object + properties: + clientAppId: + type: string + description: ID of the service principal of the Microsoft Entra app that has been granted access. Read-only. + nullable: true + clientId: + type: string + description: ID of the Microsoft Entra app that has been granted access. Read-only. + nullable: true + permission: + type: string + description: The name of the resource-specific permission. Read-only. + nullable: true + permissionType: + type: string + description: 'The type of permission. The possible values are: Application, Delegated. Read-only.' + nullable: true + resourceAppId: + type: string + description: ID of the Microsoft Entra app that is hosting the resource. Read-only. + nullable: true + additionalProperties: + type: object + microsoft.graph.profilePhoto: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: profilePhoto + 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 + additionalProperties: + type: object + microsoft.graph.plannerGroup: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: plannerGroup + type: object + properties: + plans: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.plannerPlan' + description: Read-only. Nullable. Returns the plannerPlans owned by the group. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.directorySetting: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: directorySetting + type: object + properties: + displayName: + type: string + description: 'Display name of this group of settings, which comes from the associated template. Read-only.' + nullable: true + templateId: + type: string + description: Unique identifier for the template used to create this group of settings. Read-only. + nullable: true + values: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.settingValue' + description: Collection of name-value pairs corresponding to the name and defaultValue properties in the referenced directorySettingTemplates object. + additionalProperties: + type: object + microsoft.graph.site: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItem' + - title: site + type: object + properties: + deleted: + $ref: '#/components/schemas/microsoft.graph.deleted' + displayName: + type: string + description: The full title for the site. Read-only. + nullable: true + isPersonalSite: + type: boolean + nullable: true + locale: + type: string + description: The language settings of the site. + nullable: true + lockState: + $ref: '#/components/schemas/microsoft.graph.siteLockState' + ownerIdentityToResolve: + $ref: '#/components/schemas/microsoft.graph.identityInput' + root: + $ref: '#/components/schemas/microsoft.graph.root' + settings: + $ref: '#/components/schemas/microsoft.graph.siteSettings' + shareByEmailEnabled: + type: boolean + description: Determines whether the site and its content can be shared via email. + nullable: true + sharepointIds: + $ref: '#/components/schemas/microsoft.graph.sharepointIds' + siteCollection: + $ref: '#/components/schemas/microsoft.graph.siteCollection' + template: + $ref: '#/components/schemas/microsoft.graph.siteTemplateType' + analytics: + $ref: '#/components/schemas/microsoft.graph.itemAnalytics' + columns: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The collection of column definitions reusable across lists under this site. + x-ms-navigationProperty: true + contentModels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contentModel' + description: The collection of content models applied to this site. + x-ms-navigationProperty: true + contentTypes: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contentType' + description: The collection of content types defined for this site. + x-ms-navigationProperty: true + documentProcessingJobs: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.documentProcessingJob' + description: The document processing jobs running on this site. + x-ms-navigationProperty: true + drive: + $ref: '#/components/schemas/microsoft.graph.drive' + drives: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.drive' + description: The collection of drives (document libraries) under this site. + x-ms-navigationProperty: true + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for this site. Nullable. + x-ms-navigationProperty: true + externalColumns: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The collection of column definitions available in the site that is referenced from the sites in the parent hierarchy of the current site. + x-ms-navigationProperty: true + informationProtection: + $ref: '#/components/schemas/microsoft.graph.informationProtection' + items: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.baseItem' + description: Used to address any item contained in this site. This collection can't be enumerated. + x-ms-navigationProperty: true + lists: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.list' + description: The collection of lists under this site. + x-ms-navigationProperty: true + onenote: + $ref: '#/components/schemas/microsoft.graph.onenote' + operations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation' + description: The collection of long running operations for the site. + x-ms-navigationProperty: true + pages: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.baseSitePage' + description: The collection of pages in the baseSitePages list on this site. + x-ms-navigationProperty: true + pageTemplates: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.pageTemplate' + description: The collection of page templates on this site. + x-ms-navigationProperty: true + permissions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.permission' + description: The permissions associated with the site. Nullable. + x-ms-navigationProperty: true + recycleBin: + $ref: '#/components/schemas/microsoft.graph.recycleBin' + sites: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.site' + description: The collection of the sub-sites under this site. + x-ms-navigationProperty: true + termStore: + $ref: '#/components/schemas/microsoft.graph.termStore.store' + additionalProperties: + type: object + microsoft.graph.team: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: team + type: object + properties: + classification: + type: string + description: An optional label. Typically describes the data or business sensitivity of the team. Must match one of a pre-configured set in the tenant's directory. + 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: Timestamp at which the team was created. + format: date-time + nullable: true + description: + type: string + description: 'An optional description for the team. Maximum length: 1,024 characters.' + nullable: true + discoverySettings: + $ref: '#/components/schemas/microsoft.graph.teamDiscoverySettings' + displayName: + type: string + description: The name of the team. + nullable: true + firstChannelName: + type: string + description: 'The name of the first channel in the team. This is an optional property, only used during team creation and isn''t returned in methods to get and list teams.' + nullable: true + funSettings: + $ref: '#/components/schemas/microsoft.graph.teamFunSettings' + guestSettings: + $ref: '#/components/schemas/microsoft.graph.teamGuestSettings' + internalId: + type: string + description: A unique ID for the team used in a few places such as the audit log/Office 365 Management Activity API. + nullable: true + isArchived: + type: boolean + description: Whether this team is in read-only mode. + nullable: true + isMembershipLimitedToOwners: + type: boolean + description: 'If set to true, the team is currently in the owner-only team membership state and inaccessible by other team members, such as students.' + nullable: true + memberSettings: + $ref: '#/components/schemas/microsoft.graph.teamMemberSettings' + messagingSettings: + $ref: '#/components/schemas/microsoft.graph.teamMessagingSettings' + specialization: + $ref: '#/components/schemas/microsoft.graph.teamSpecialization' + summary: + $ref: '#/components/schemas/microsoft.graph.teamSummary' + tenantId: + type: string + description: The ID of the Microsoft Entra tenant. + nullable: true + visibility: + $ref: '#/components/schemas/microsoft.graph.teamVisibilityType' + webUrl: + type: string + description: 'A hyperlink that goes to the team in the Microsoft Teams client. It''s the URL you get when you right-click a team in the Microsoft Teams client and select Get link to team. This URL should be treated as an opaque blob, and not parsed.' + nullable: true + allChannels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.channel' + description: List of channels either hosted in or shared with the team (incoming channels). + x-ms-navigationProperty: true + channels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.channel' + description: The collection of channels and messages associated with the team. + x-ms-navigationProperty: true + group: + $ref: '#/components/schemas/microsoft.graph.group' + incomingChannels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.channel' + description: List of channels shared with the team. + x-ms-navigationProperty: true + installedApps: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.teamsAppInstallation' + description: The apps installed in this team. + x-ms-navigationProperty: true + members: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.conversationMember' + description: Members and owners of the team. + x-ms-navigationProperty: true + operations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.teamsAsyncOperation' + description: The async operations that ran or are running on this team. + x-ms-navigationProperty: true + owners: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.user' + description: 'The list of this team''s owners. Currently, when creating a team using application permissions, exactly one owner must be specified. When using user-delegated permissions, no owner can be specified (the current user is the owner). The owner must be specified as an object ID (GUID), not a UPN.' + x-ms-navigationProperty: true + permissionGrants: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.resourceSpecificPermissionGrant' + description: A collection of permissions granted to apps to access the team. + x-ms-navigationProperty: true + photo: + $ref: '#/components/schemas/microsoft.graph.profilePhoto' + primaryChannel: + $ref: '#/components/schemas/microsoft.graph.channel' + schedule: + $ref: '#/components/schemas/microsoft.graph.schedule' + tags: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.teamworkTag' + description: The tags associated with the team. + x-ms-navigationProperty: true + template: + $ref: '#/components/schemas/microsoft.graph.teamsTemplate' + templateDefinition: + $ref: '#/components/schemas/microsoft.graph.teamTemplateDefinition' + additionalProperties: + type: object + microsoft.graph.conversationThread: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: conversationThread + type: object + properties: + ccRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The Cc: recipients for the thread. Returned only on $select.' + hasAttachments: + type: boolean + description: Indicates whether any of the posts within this thread has at least one attachment. Returned by default. + isLocked: + type: boolean + description: Indicates if the thread is locked. Returned by default. + lastDeliveredDateTime: + 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 Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Returned by default.' + format: date-time + preview: + type: string + description: A short summary from the body of the latest post in this conversation. Returned by default. + topic: + type: string + description: 'The topic of the conversation. This property can be set when the conversation is created, but it cannot be updated. Returned by default.' + toRecipients: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: 'The To: recipients for the thread. Returned only on $select.' + uniqueSenders: + type: array + items: + type: string + description: All the users that sent a message to this thread. Returned by default. + posts: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.post' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.windowsUpdates.safeguardCategory: + title: safeguardCategory + enum: + - likelyIssues + - unknownFutureValue + type: string + microsoft.graph.cloudLicensing.assignment: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: assignment + type: object + properties: + disabledServicePlanIds: + type: array + items: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + format: uuid + description: The list of disabled service plans for this assignment. Not nullable. + allotment: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.allotment' + assignedTo: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + additionalProperties: + type: object + microsoft.graph.cloudLicensing.usageRight: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: usageRight + type: object + properties: + services: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.service' + description: Information about the services associated with the usageRight. Not nullable. Read-only. Supports $filter on the planId property. + skuId: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + description: Unique identifier (GUID) for the service SKU that is equal to the skuId property on the related subscribedSku object. Read-only. Supports $filter. + format: uuid + nullable: true + skuPartNumber: + type: string + description: 'Unique SKU display name that is equal to the skuPartNumber on the related subscribedSku object; for example, AAD_Premium. Read-only.' + nullable: true + allotments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.allotment' + description: The set of allotments associated with the assignments that combine to form this usageRight. + x-ms-navigationProperty: true + assignments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.assignment' + description: 'The set of assignments that combine to form this usageRight, including both direct assignments and assignments inherited through group membership.' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.MembershipRuleProcessingStatusDetails: + title: MembershipRuleProcessingStatusDetails + enum: + - NotStarted + - Running + - Failed + - Succeeded + - UnsupportedFutureValue + type: string + microsoft.graph.writebackConfiguration: + title: writebackConfiguration + type: object + properties: + isEnabled: + type: boolean + description: Indicates whether writeback of cloud groups to on-premise Active Directory is enabled. Default value is true for Microsoft 365 groups and false for security groups. + nullable: true + additionalProperties: + type: object + microsoft.graph.onlineMeetingProviderType: + title: onlineMeetingProviderType + enum: + - unknown + - skypeForBusiness + - skypeForConsumer + - teamsForBusiness + type: string + microsoft.graph.calendarColor: + title: calendarColor + enum: + - auto + - lightBlue + - lightGreen + - lightOrange + - lightGray + - lightYellow + - lightTeal + - lightPink + - lightBrown + - lightRed + - maxColor + type: string + microsoft.graph.emailAddress: + title: emailAddress + type: object + properties: + address: + type: string + description: The email address of an entity instance. + nullable: true + name: + type: string + description: The display name of an entity instance. + nullable: true + additionalProperties: + type: object + microsoft.graph.calendarPermission: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: calendarPermission + type: object + properties: + allowedRoles: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.calendarRoleType' + description: 'List of allowed sharing or delegating permission levels for the calendar. The possible values are: none, freeBusyRead, limitedRead, read, write, delegateWithoutPrivateEventAccess, delegateWithPrivateEventAccess, custom.' + emailAddress: + $ref: '#/components/schemas/microsoft.graph.emailAddress' + isInsideOrganization: + type: boolean + description: True if the user in context (share recipient or delegate) is inside the same organization as the calendar owner. + nullable: true + isRemovable: + type: boolean + description: 'True if the user can be removed from the list of recipients or delegates for the specified calendar, false otherwise. The ''My organization'' user determines the permissions other people within your organization have to the given calendar. You can''t remove ''My organization'' as a recipient to a calendar.' + nullable: true + role: + $ref: '#/components/schemas/microsoft.graph.calendarRoleType' + additionalProperties: + type: object + microsoft.graph.multiValueLegacyExtendedProperty: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: multiValueLegacyExtendedProperty + type: object + properties: + value: + type: array + items: + type: string + nullable: true + description: A collection of property values. + additionalProperties: + type: object + microsoft.graph.singleValueLegacyExtendedProperty: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: singleValueLegacyExtendedProperty + type: object + properties: + value: + type: string + description: A property value. + nullable: true + additionalProperties: + type: object + microsoft.graph.outlookItem: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: outlookItem + type: object + properties: + categories: + type: array + items: + type: string + nullable: true + description: The categories associated with the item. + changeKey: + type: string + description: 'Identifies the version of the item. Every time the item is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.' + 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: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + lastModifiedDateTime: + 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 Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.attendee: + allOf: + - $ref: '#/components/schemas/microsoft.graph.attendeeBase' + - title: attendee + type: object + properties: + proposedNewTime: + $ref: '#/components/schemas/microsoft.graph.timeSlot' + status: + $ref: '#/components/schemas/microsoft.graph.responseStatus' + additionalProperties: + type: object + microsoft.graph.itemBody: + title: itemBody + type: object + properties: + content: + type: string + description: The content of the item. + nullable: true + contentType: + $ref: '#/components/schemas/microsoft.graph.bodyType' + additionalProperties: + type: object + microsoft.graph.dateTimeTimeZone: + title: dateTimeTimeZone + type: object + properties: + dateTime: + type: string + description: 'A single point of time in a combined date and time representation ({date}T{time}). For example, ''2019-04-16T09:00:00''.' + timeZone: + type: string + description: 'Represents a time zone, for example, ''Pacific Standard Time''. See below for possible values.' + nullable: true + additionalProperties: + type: object + microsoft.graph.importance: + title: importance + enum: + - low + - normal + - high + type: string + microsoft.graph.location: + title: location + type: object + properties: + address: + $ref: '#/components/schemas/microsoft.graph.physicalAddress' + coordinates: + $ref: '#/components/schemas/microsoft.graph.outlookGeoCoordinates' + displayName: + type: string + description: The name associated with the location. + nullable: true + locationEmailAddress: + type: string + description: Optional email address of the location. + nullable: true + locationType: + $ref: '#/components/schemas/microsoft.graph.locationType' + locationUri: + type: string + description: Optional URI representing the location. + nullable: true + uniqueId: + type: string + description: For internal use only. + nullable: true + uniqueIdType: + $ref: '#/components/schemas/microsoft.graph.locationUniqueIdType' + additionalProperties: + type: object + microsoft.graph.onlineMeetingInfo: + title: onlineMeetingInfo + type: object + properties: + conferenceId: + type: string + description: The ID of the conference. + nullable: true + joinUrl: + type: string + description: The external link that launches the online meeting. This is a URL that clients launch into a browser and will redirect the user to join the meeting. + nullable: true + phones: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.phone' + description: All of the phone numbers associated with this conference. + quickDial: + type: string + description: The preformatted quick dial for this call. + nullable: true + tollFreeNumbers: + type: array + items: + type: string + nullable: true + description: The toll free numbers that can be used to join the conference. + tollNumber: + type: string + description: The toll number that can be used to join the conference. + nullable: true + additionalProperties: + type: object + microsoft.graph.recipient: + title: recipient + type: object + properties: + emailAddress: + $ref: '#/components/schemas/microsoft.graph.emailAddress' + additionalProperties: + type: object + microsoft.graph.patternedRecurrence: + title: patternedRecurrence + type: object + properties: + pattern: + $ref: '#/components/schemas/microsoft.graph.recurrencePattern' + range: + $ref: '#/components/schemas/microsoft.graph.recurrenceRange' + additionalProperties: + type: object + microsoft.graph.responseStatus: + title: responseStatus + type: object + properties: + response: + $ref: '#/components/schemas/microsoft.graph.responseType' + time: + 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 date and time that the response was returned. It uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.sensitivity: + title: sensitivity + enum: + - normal + - personal + - private + - confidential + type: string + microsoft.graph.freeBusyStatus: + title: freeBusyStatus + enum: + - unknown + - free + - tentative + - busy + - oof + - workingElsewhere + type: string + microsoft.graph.eventType: + title: eventType + enum: + - singleInstance + - occurrence + - exception + - seriesMaster + type: string + microsoft.graph.attachment: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: attachment + type: object + properties: + contentType: + type: string + description: The MIME type. + nullable: true + isInline: + type: boolean + description: 'true if the attachment is an inline attachment; otherwise, false.' + lastModifiedDateTime: + 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 Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + name: + type: string + description: The display name of the attachment. This does not need to be the actual file name. + nullable: true + size: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The length of the attachment in bytes. + format: int32 + additionalProperties: + type: object + microsoft.graph.baseItem: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: baseItem + type: object + properties: + createdBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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 item creation. Read-only. + format: date-time + description: + type: string + description: The description of the item. + nullable: true + eTag: + type: string + description: ETag for the item. Read-only. + nullable: true + lastModifiedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + lastModifiedDateTime: + 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 the item was last modified. Read-only. + format: date-time + name: + type: string + description: The name of the item. Read-write. + nullable: true + parentReference: + $ref: '#/components/schemas/microsoft.graph.itemReference' + webUrl: + type: string + description: 'URL that either displays the resource in the browser (for Office file formats), or is a direct link to the file (for other formats). Read-only.' + nullable: true + createdByUser: + $ref: '#/components/schemas/microsoft.graph.user' + lastModifiedByUser: + $ref: '#/components/schemas/microsoft.graph.user' + additionalProperties: + type: object + microsoft.graph.identitySet: + title: identitySet + type: object + properties: + application: + $ref: '#/components/schemas/microsoft.graph.identity' + device: + $ref: '#/components/schemas/microsoft.graph.identity' + user: + $ref: '#/components/schemas/microsoft.graph.identity' + additionalProperties: + type: object + microsoft.graph.quota: + title: quota + type: object + properties: + deleted: + type: number + description: 'Total space consumed by files in the recycle bin, in bytes. Read-only.' + format: int64 + nullable: true + remaining: + type: number + description: 'Total space remaining before reaching the quota limit, in bytes. Read-only.' + format: int64 + nullable: true + state: + type: string + description: Enumeration value that indicates the state of the storage space. Read-only. + nullable: true + storagePlanInformation: + $ref: '#/components/schemas/microsoft.graph.storagePlanInformation' + total: + type: number + description: 'Total allowed storage space, in bytes. Read-only.' + format: int64 + nullable: true + used: + type: number + description: 'Total space used, in bytes. Read-only.' + format: int64 + nullable: true + additionalProperties: + type: object + microsoft.graph.sharepointIds: + title: sharepointIds + type: object + properties: + listId: + type: string + description: The unique identifier (guid) for the item's list in SharePoint. + nullable: true + listItemId: + type: string + description: An integer identifier for the item within the containing list. + nullable: true + listItemUniqueId: + type: string + description: The unique identifier (guid) for the item within OneDrive for Business or a SharePoint site. + nullable: true + siteId: + type: string + description: The unique identifier (guid) for the item's site collection (SPSite). + nullable: true + siteUrl: + type: string + description: The SharePoint URL for the site that contains the item. + nullable: true + tenantId: + type: string + description: The unique identifier (guid) for the tenancy. + nullable: true + webId: + type: string + description: The unique identifier (guid) for the item's site (SPWeb). + nullable: true + additionalProperties: + type: object + microsoft.graph.systemFacet: + title: systemFacet + type: object + additionalProperties: + type: object + microsoft.graph.itemActivityOLD: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: itemActivityOLD + type: object + properties: + action: + $ref: '#/components/schemas/microsoft.graph.itemActionSet' + actor: + $ref: '#/components/schemas/microsoft.graph.identitySet' + times: + $ref: '#/components/schemas/microsoft.graph.itemActivityTimeSet' + driveItem: + $ref: '#/components/schemas/microsoft.graph.driveItem' + listItem: + $ref: '#/components/schemas/microsoft.graph.listItem' + additionalProperties: + type: object + microsoft.graph.driveItem: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItem' + - title: driveItem + type: object + properties: + audio: + $ref: '#/components/schemas/microsoft.graph.audio' + bundle: + $ref: '#/components/schemas/microsoft.graph.bundle' + content: + type: string + description: 'The content stream, if the item represents a file. The content property will have a potentially breaking change in behavior in the future. It will stream content directly instead of redirecting. To proactively opt in to the new behavior ahead of time, use the contentStream property instead.' + format: base64url + nullable: true + contentStream: + type: string + description: 'The content stream, if the item represents a file.' + format: base64url + nullable: true + cTag: + type: string + description: An eTag for the content of the item. This eTag isn't changed if only the metadata is changed. Note This property isn't returned if the item is a folder. Read-only. + nullable: true + deleted: + $ref: '#/components/schemas/microsoft.graph.deleted' + file: + $ref: '#/components/schemas/microsoft.graph.file' + fileSystemInfo: + $ref: '#/components/schemas/microsoft.graph.fileSystemInfo' + folder: + $ref: '#/components/schemas/microsoft.graph.folder' + image: + $ref: '#/components/schemas/microsoft.graph.image' + location: + $ref: '#/components/schemas/microsoft.graph.geoCoordinates' + malware: + $ref: '#/components/schemas/microsoft.graph.malware' + media: + $ref: '#/components/schemas/microsoft.graph.media' + package: + $ref: '#/components/schemas/microsoft.graph.package' + pendingOperations: + $ref: '#/components/schemas/microsoft.graph.pendingOperations' + photo: + $ref: '#/components/schemas/microsoft.graph.photo' + publication: + $ref: '#/components/schemas/microsoft.graph.publicationFacet' + remoteItem: + $ref: '#/components/schemas/microsoft.graph.remoteItem' + root: + $ref: '#/components/schemas/microsoft.graph.root' + searchResult: + $ref: '#/components/schemas/microsoft.graph.searchResult' + shared: + $ref: '#/components/schemas/microsoft.graph.shared' + sharepointIds: + $ref: '#/components/schemas/microsoft.graph.sharepointIds' + size: + type: number + description: Size of the item in bytes. Read-only. + format: int64 + nullable: true + source: + $ref: '#/components/schemas/microsoft.graph.driveItemSource' + specialFolder: + $ref: '#/components/schemas/microsoft.graph.specialFolder' + video: + $ref: '#/components/schemas/microsoft.graph.video' + viewpoint: + $ref: '#/components/schemas/microsoft.graph.driveItemViewpoint' + webDavUrl: + type: string + description: WebDAV compatible URL for the item. + nullable: true + activities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.itemActivityOLD' + description: The list of recent activities that took place on this item. + x-ms-navigationProperty: true + analytics: + $ref: '#/components/schemas/microsoft.graph.itemAnalytics' + children: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.driveItem' + description: Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable. + x-ms-navigationProperty: true + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for this item. Nullable. + x-ms-navigationProperty: true + listItem: + $ref: '#/components/schemas/microsoft.graph.listItem' + permissions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.permission' + description: The set of permissions for the item. Read-only. Nullable. + x-ms-navigationProperty: true + retentionLabel: + $ref: '#/components/schemas/microsoft.graph.itemRetentionLabel' + subscriptions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.subscription' + description: The set of subscriptions on the item. Only supported on the root of a drive. + x-ms-navigationProperty: true + thumbnails: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.thumbnailSet' + description: 'Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.' + x-ms-navigationProperty: true + versions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.driveItemVersion' + description: 'The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.' + x-ms-navigationProperty: true + workbook: + $ref: '#/components/schemas/microsoft.graph.workbook' + additionalProperties: + type: object + microsoft.graph.list: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItem' + - title: list + type: object + properties: + displayName: + type: string + description: The displayable title of the list. + nullable: true + itemCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of items in the list. Read-only. + format: int32 + nullable: true + list: + $ref: '#/components/schemas/microsoft.graph.listInfo' + sharepointIds: + $ref: '#/components/schemas/microsoft.graph.sharepointIds' + system: + $ref: '#/components/schemas/microsoft.graph.systemFacet' + activities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.itemActivityOLD' + description: The recent activities that took place within this list. + x-ms-navigationProperty: true + columns: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The collection of field definitions for this list. + x-ms-navigationProperty: true + contentTypes: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contentType' + description: The collection of content types present in this list. + x-ms-navigationProperty: true + drive: + $ref: '#/components/schemas/microsoft.graph.drive' + items: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.listItem' + description: All items contained in the list. + x-ms-navigationProperty: true + operations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.richLongRunningOperation' + description: The collection of long-running operations on the list. + x-ms-navigationProperty: true + permissions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.permission' + description: The set of permissions for the item. Read-only. Nullable. + x-ms-navigationProperty: true + subscriptions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.subscription' + description: The set of subscriptions on the list. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.notebook: + allOf: + - $ref: '#/components/schemas/microsoft.graph.onenoteEntityHierarchyModel' + - title: notebook + type: object + properties: + isDefault: + type: boolean + description: Indicates whether this is the user's default notebook. Read-only. + nullable: true + isShared: + type: boolean + description: 'Indicates whether the notebook is shared. If true, the contents of the notebook can be seen by people other than the owner. Read-only.' + nullable: true + links: + $ref: '#/components/schemas/microsoft.graph.notebookLinks' + sectionGroupsUrl: + type: string + description: 'The URL for the sectionGroups navigation property, which returns all the section groups in the notebook. Read-only.' + nullable: true + sectionsUrl: + type: string + description: 'The URL for the sections navigation property, which returns all the sections in the notebook. Read-only.' + nullable: true + userRole: + $ref: '#/components/schemas/microsoft.graph.onenoteUserRole' + sectionGroups: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.sectionGroup' + description: The section groups in the notebook. Read-only. Nullable. + x-ms-navigationProperty: true + sections: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onenoteSection' + description: The sections in the notebook. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.onenoteOperation: + allOf: + - $ref: '#/components/schemas/microsoft.graph.operation' + - title: onenoteOperation + type: object + properties: + error: + $ref: '#/components/schemas/microsoft.graph.onenoteOperationError' + percentComplete: + type: string + description: The operation percent complete if the operation is still in running status. + nullable: true + resourceId: + type: string + description: The resource id. + nullable: true + resourceLocation: + type: string + description: 'The resource URI for the object. For example, the resource URI for a copied page or section.' + nullable: true + additionalProperties: + type: object + microsoft.graph.onenotePage: + allOf: + - $ref: '#/components/schemas/microsoft.graph.onenoteEntitySchemaObjectModel' + - title: onenotePage + type: object + properties: + content: + type: string + description: The page's HTML content. + format: base64url + nullable: true + contentUrl: + type: string + description: The URL for the page's HTML content. Read-only. + nullable: true + createdByAppId: + type: string + description: The unique identifier of the application that created the page. Read-only. + nullable: true + lastModifiedDateTime: + 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 date and time when the page was last modified. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + level: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The indentation level of the page. Read-only. + format: int32 + nullable: true + links: + $ref: '#/components/schemas/microsoft.graph.pageLinks' + order: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The order of the page within its parent section. Read-only. + format: int32 + nullable: true + title: + type: string + description: The title of the page. + nullable: true + userTags: + type: array + items: + type: string + nullable: true + parentNotebook: + $ref: '#/components/schemas/microsoft.graph.notebook' + parentSection: + $ref: '#/components/schemas/microsoft.graph.onenoteSection' + additionalProperties: + type: object + microsoft.graph.onenoteResource: + allOf: + - $ref: '#/components/schemas/microsoft.graph.onenoteEntityBaseModel' + - title: onenoteResource + type: object + properties: + content: + type: string + description: The content of the resource. + format: base64url + nullable: true + contentUrl: + type: string + description: The URL for the content stream. + nullable: true + additionalProperties: + type: object + microsoft.graph.sectionGroup: + allOf: + - $ref: '#/components/schemas/microsoft.graph.onenoteEntityHierarchyModel' + - title: sectionGroup + type: object + properties: + sectionGroupsUrl: + type: string + description: 'The URL for the sectionGroups navigation property, which returns all the section groups in the section group. Read-only.' + nullable: true + sectionsUrl: + type: string + description: 'The URL for the sections navigation property, which returns all the sections in the section group. Read-only.' + nullable: true + parentNotebook: + $ref: '#/components/schemas/microsoft.graph.notebook' + parentSectionGroup: + $ref: '#/components/schemas/microsoft.graph.sectionGroup' + sectionGroups: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.sectionGroup' + description: The section groups in the section. Read-only. Nullable. + x-ms-navigationProperty: true + sections: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onenoteSection' + description: The sections in the section group. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.onenoteSection: + allOf: + - $ref: '#/components/schemas/microsoft.graph.onenoteEntityHierarchyModel' + - title: onenoteSection + type: object + properties: + isDefault: + type: boolean + description: Indicates whether this is the user's default section. Read-only. + nullable: true + links: + $ref: '#/components/schemas/microsoft.graph.sectionLinks' + pagesUrl: + type: string + description: The pages endpoint where you can get details for all the pages in the section. Read-only. + nullable: true + pages: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onenotePage' + description: The collection of pages in the section. Read-only. Nullable. + x-ms-navigationProperty: true + parentNotebook: + $ref: '#/components/schemas/microsoft.graph.notebook' + parentSectionGroup: + $ref: '#/components/schemas/microsoft.graph.sectionGroup' + additionalProperties: + type: object + microsoft.graph.plannerPlan: + allOf: + - $ref: '#/components/schemas/microsoft.graph.plannerDelta' + - title: plannerPlan + type: object + properties: + archivalInfo: + $ref: '#/components/schemas/microsoft.graph.plannerArchivalInfo' + container: + $ref: '#/components/schemas/microsoft.graph.plannerPlanContainer' + contentSensitivityLabelAssignment: + $ref: '#/components/schemas/microsoft.graph.contentSensitivityLabelAssignment' + contexts: + $ref: '#/components/schemas/microsoft.graph.plannerPlanContextCollection' + createdBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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: 'Read-only. Date and time at which the plan is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + creationSource: + $ref: '#/components/schemas/microsoft.graph.plannerPlanCreation' + isArchived: + type: boolean + description: 'Read-only. If set to true, the plan is archived. An archived plan is read-only.' + nullable: true + owner: + type: string + description: 'Use the container property instead. ID of the group that owns the plan. After it''s set, this property can’t be updated. This property doesn''t return a valid group ID if the container of the plan isn''t a group.' + nullable: true + sharedWithContainers: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.plannerSharedWithContainer' + description: List of containers the plan is shared with. + title: + type: string + description: Required. Title of the plan. + buckets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.plannerBucket' + description: Collection of buckets in the plan. Read-only. Nullable. + x-ms-navigationProperty: true + details: + $ref: '#/components/schemas/microsoft.graph.plannerPlanDetails' + tasks: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.plannerTask' + description: Collection of tasks in the plan. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.settingValue: + title: settingValue + type: object + properties: + name: + type: string + description: Name of the setting (as defined by the directorySettingTemplate). + nullable: true + value: + type: string + description: Value of the setting. + nullable: true + additionalProperties: + type: object + microsoft.graph.deleted: + title: deleted + type: object + properties: + state: + type: string + description: Represents the state of the deleted item. + nullable: true + additionalProperties: + type: object + microsoft.graph.siteLockState: + title: siteLockState + enum: + - unlocked + - lockedReadOnly + - lockedNoAccess + - lockedNoAdditions + - unknownFutureValue + type: string + microsoft.graph.identityInput: + title: identityInput + type: object + properties: + alias: + type: string + description: The alias of the identity. + nullable: true + email: + type: string + description: The email of the identity. + nullable: true + objectId: + type: string + description: The unique object ID assigned to the identity in Microsoft Entra ID. + nullable: true + additionalProperties: + type: object + microsoft.graph.root: + title: root + type: object + additionalProperties: + type: object + microsoft.graph.siteSettings: + title: siteSettings + type: object + properties: + languageTag: + type: string + description: The language tag for the language used on this site. + nullable: true + timeZone: + type: string + description: Indicates the time offset for the time zone of the site from Coordinated Universal Time (UTC). + nullable: true + additionalProperties: + type: object + microsoft.graph.siteCollection: + title: siteCollection + type: object + properties: + archivalDetails: + $ref: '#/components/schemas/microsoft.graph.siteArchivalDetails' + dataLocationCode: + type: string + description: The geographic region code for where this site collection resides. Only present for multi-geo tenants. Read-only. + nullable: true + hostname: + type: string + description: The hostname for the site collection. Read-only. + nullable: true + root: + $ref: '#/components/schemas/microsoft.graph.root' + additionalProperties: + type: object + microsoft.graph.siteTemplateType: + title: siteTemplateType + enum: + - sitepagepublishing + - sts + - unknownFutureValue + type: string + microsoft.graph.itemAnalytics: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: itemAnalytics + type: object + properties: + allTime: + $ref: '#/components/schemas/microsoft.graph.itemActivityStat' + itemActivityStats: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.itemActivityStat' + x-ms-navigationProperty: true + lastSevenDays: + $ref: '#/components/schemas/microsoft.graph.itemActivityStat' + additionalProperties: + type: object + microsoft.graph.columnDefinition: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: columnDefinition + type: object + properties: + boolean: + $ref: '#/components/schemas/microsoft.graph.booleanColumn' + calculated: + $ref: '#/components/schemas/microsoft.graph.calculatedColumn' + choice: + $ref: '#/components/schemas/microsoft.graph.choiceColumn' + columnGroup: + type: string + description: 'For site columns, the name of the group this column belongs to. Helps organize related columns.' + nullable: true + contentApprovalStatus: + $ref: '#/components/schemas/microsoft.graph.contentApprovalStatusColumn' + currency: + $ref: '#/components/schemas/microsoft.graph.currencyColumn' + dateTime: + $ref: '#/components/schemas/microsoft.graph.dateTimeColumn' + defaultValue: + $ref: '#/components/schemas/microsoft.graph.defaultColumnValue' + description: + type: string + description: The user-facing description of the column. + nullable: true + displayName: + type: string + description: The user-facing name of the column. + nullable: true + enforceUniqueValues: + type: boolean + description: 'If true, no two list items may have the same value for this column.' + nullable: true + geolocation: + $ref: '#/components/schemas/microsoft.graph.geolocationColumn' + hidden: + type: boolean + description: Specifies whether the column is displayed in the user interface. + nullable: true + hyperlinkOrPicture: + $ref: '#/components/schemas/microsoft.graph.hyperlinkOrPictureColumn' + indexed: + type: boolean + description: Specifies whether the column values can used for sorting and searching. + nullable: true + isDeletable: + type: boolean + description: Indicates whether this column can be deleted. + nullable: true + isReorderable: + type: boolean + description: Indicates whether values in the column can be reordered. Read-only. + nullable: true + isSealed: + type: boolean + description: Specifies whether the column can be changed. + nullable: true + lookup: + $ref: '#/components/schemas/microsoft.graph.lookupColumn' + name: + type: string + description: 'The API-facing name of the column as it appears in the fields on a listItem. For the user-facing name, see displayName.' + nullable: true + number: + $ref: '#/components/schemas/microsoft.graph.numberColumn' + personOrGroup: + $ref: '#/components/schemas/microsoft.graph.personOrGroupColumn' + propagateChanges: + type: boolean + description: 'If true, changes to this column will be propagated to lists that implement the column.' + nullable: true + readOnly: + type: boolean + description: Specifies whether the column values can be modified. + nullable: true + required: + type: boolean + description: Specifies whether the column value isn't optional. + nullable: true + sourceContentType: + $ref: '#/components/schemas/microsoft.graph.contentTypeInfo' + term: + $ref: '#/components/schemas/microsoft.graph.termColumn' + text: + $ref: '#/components/schemas/microsoft.graph.textColumn' + thumbnail: + $ref: '#/components/schemas/microsoft.graph.thumbnailColumn' + type: + $ref: '#/components/schemas/microsoft.graph.columnTypes' + validation: + $ref: '#/components/schemas/microsoft.graph.columnValidation' + sourceColumn: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + additionalProperties: + type: object + microsoft.graph.contentModel: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: contentModel + type: object + properties: + createdBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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 item creation. Read-only. + format: date-time + nullable: true + lastModifiedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + lastModifiedDateTime: + 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 item last modification. Read-only. + format: date-time + nullable: true + modelType: + $ref: '#/components/schemas/microsoft.graph.contentModelType' + name: + type: string + description: The name of the contentModel. + nullable: true + additionalProperties: + type: object + microsoft.graph.contentType: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: contentType + type: object + properties: + associatedHubsUrls: + type: array + items: + type: string + nullable: true + description: List of canonical URLs for hub sites with which this content type is associated to. This contains all hub sites where this content type is queued to be enforced or is already enforced. Enforcing a content type means that the content type is applied to the lists in the enforced sites. + description: + type: string + description: The descriptive text for the item. + nullable: true + documentSet: + $ref: '#/components/schemas/microsoft.graph.documentSet' + documentTemplate: + $ref: '#/components/schemas/microsoft.graph.documentSetContent' + group: + type: string + description: The name of the group this content type belongs to. Helps organize related content types. + nullable: true + hidden: + type: boolean + description: Indicates whether the content type is hidden in the list's 'New' menu. + nullable: true + inheritedFrom: + $ref: '#/components/schemas/microsoft.graph.itemReference' + isBuiltIn: + type: boolean + description: Specifies if a content type is a built-in content type. + nullable: true + name: + type: string + description: The name of the content type. + nullable: true + order: + $ref: '#/components/schemas/microsoft.graph.contentTypeOrder' + parentId: + type: string + description: The unique identifier of the content type. + nullable: true + propagateChanges: + type: boolean + description: 'If true, any changes made to the content type are pushed to inherited content types and lists that implement the content type.' + nullable: true + readOnly: + type: boolean + description: 'If true, the content type can''t be modified unless this value is first set to false.' + nullable: true + sealed: + type: boolean + description: 'If true, the content type can''t be modified by users or through push-down operations. Only site collection administrators can seal or unseal content types.' + nullable: true + base: + $ref: '#/components/schemas/microsoft.graph.contentType' + baseTypes: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contentType' + description: The collection of content types that are ancestors of this content type. + x-ms-navigationProperty: true + columnLinks: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnLink' + description: The collection of columns that are required by this content type. + x-ms-navigationProperty: true + columnPositions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: Column order information in a content type. + x-ms-navigationProperty: true + columns: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The collection of column definitions for this content type. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.documentProcessingJob: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: documentProcessingJob + type: object + properties: + 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 item creation. Read-only. + format: date-time + nullable: true + jobType: + $ref: '#/components/schemas/microsoft.graph.documentProcessingJobType' + listItemUniqueId: + type: string + description: 'The listItemUniqueId of the file, or folder to process. Use GET driveItem resource operation and read sharepointIds property to get listItemUniqueId.' + status: + $ref: '#/components/schemas/microsoft.graph.documentProcessingJobStatus' + additionalProperties: + type: object + microsoft.graph.informationProtection: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: informationProtection + type: object + properties: + bitlocker: + $ref: '#/components/schemas/microsoft.graph.bitlocker' + dataLossPreventionPolicies: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.dataLossPreventionPolicy' + x-ms-navigationProperty: true + policy: + $ref: '#/components/schemas/microsoft.graph.informationProtectionPolicy' + sensitivityLabels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.sensitivityLabel' + x-ms-navigationProperty: true + sensitivityPolicySettings: + $ref: '#/components/schemas/microsoft.graph.sensitivityPolicySettings' + threatAssessmentRequests: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.threatAssessmentRequest' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.richLongRunningOperation: + allOf: + - $ref: '#/components/schemas/microsoft.graph.longRunningOperation' + - title: richLongRunningOperation + type: object + properties: + error: + $ref: '#/components/schemas/microsoft.graph.publicError' + 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: A unique identifier for the result. + nullable: true + type: + type: string + description: Type of the operation. + nullable: true + additionalProperties: + type: object + description: The status of a long-running operation. + microsoft.graph.baseSitePage: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItem' + - title: baseSitePage + type: object + properties: + pageLayout: + $ref: '#/components/schemas/microsoft.graph.pageLayoutType' + publishingState: + $ref: '#/components/schemas/microsoft.graph.publicationFacet' + title: + type: string + description: Title of the sitePage. + nullable: true + additionalProperties: + type: object + microsoft.graph.pageTemplate: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseSitePage' + - title: pageTemplate + type: object + properties: + titleArea: + $ref: '#/components/schemas/microsoft.graph.titleArea' + canvasLayout: + $ref: '#/components/schemas/microsoft.graph.canvasLayout' + webParts: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.webPart' + description: The collection of web parts on the SharePoint page. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.permission: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: permission + type: object + properties: + expirationDateTime: + 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: A format of yyyy-MM-ddTHH:mm:ssZ of DateTimeOffset indicates the expiration time of the permission. DateTime.MinValue indicates there's no expiration set for this permission. Optional. + format: date-time + nullable: true + grantedTo: + $ref: '#/components/schemas/microsoft.graph.identitySet' + grantedToIdentities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.identitySet' + description: 'For type permissions, the details of the users to whom permission was granted. Read-only.' + grantedToIdentitiesV2: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.sharePointIdentitySet' + description: 'For link type permissions, the details of the users to whom permission was granted. Read-only.' + grantedToV2: + $ref: '#/components/schemas/microsoft.graph.sharePointIdentitySet' + hasPassword: + type: boolean + description: Indicates whether the password is set for this permission. This property only appears in the response. Optional. Read-only. For OneDrive Personal only. + nullable: true + inheritedFrom: + $ref: '#/components/schemas/microsoft.graph.itemReference' + invitation: + $ref: '#/components/schemas/microsoft.graph.sharingInvitation' + link: + $ref: '#/components/schemas/microsoft.graph.sharingLink' + roles: + type: array + items: + type: string + nullable: true + description: 'The type of permission, for example, read. See the Roles property values section for the full list of roles. Read-only.' + shareId: + type: string + description: A unique token that can be used to access this shared item via the shares API. Read-only. + nullable: true + additionalProperties: + type: object + microsoft.graph.recycleBin: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItem' + - title: recycleBin + type: object + properties: + settings: + $ref: '#/components/schemas/microsoft.graph.recycleBinSettings' + items: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recycleBinItem' + description: List of the recycleBinItems deleted by a user. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.termStore.store: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: store + type: object + properties: + defaultLanguageTag: + type: string + description: Default language of the term store. + languageTags: + type: array + items: + type: string + description: List of languages for the term store. + groups: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.termStore.group' + description: Collection of all groups available in the term store. + x-ms-navigationProperty: true + sets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.termStore.set' + description: Collection of all sets available in the term store. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.teamDiscoverySettings: + title: teamDiscoverySettings + type: object + properties: + showInTeamsSearchAndSuggestions: + type: boolean + description: 'If set to true, the team is visible via search and suggestions from the Teams client.' + nullable: true + additionalProperties: + type: object + microsoft.graph.teamFunSettings: + title: teamFunSettings + type: object + properties: + allowCustomMemes: + type: boolean + description: 'If set to true, enables users to include custom memes.' + nullable: true + allowGiphy: + type: boolean + description: 'If set to true, enables Giphy use.' + nullable: true + allowStickersAndMemes: + type: boolean + description: 'If set to true, enables users to include stickers and memes.' + nullable: true + giphyContentRating: + $ref: '#/components/schemas/microsoft.graph.giphyRatingType' + additionalProperties: + type: object + microsoft.graph.teamGuestSettings: + title: teamGuestSettings + type: object + properties: + allowCreateUpdateChannels: + type: boolean + description: 'If set to true, guests can add and update channels.' + nullable: true + allowDeleteChannels: + type: boolean + description: 'If set to true, guests can delete channels.' + nullable: true + additionalProperties: + type: object + microsoft.graph.teamMemberSettings: + title: teamMemberSettings + type: object + properties: + allowAddRemoveApps: + type: boolean + description: 'If set to true, members can add and remove apps.' + nullable: true + allowCreatePrivateChannels: + type: boolean + description: 'If set to true, members can add and update private channels.' + nullable: true + allowCreateUpdateChannels: + type: boolean + description: 'If set to true, members can add and update any channels.' + nullable: true + allowCreateUpdateRemoveConnectors: + type: boolean + description: 'If set to true, members can add, update, and remove connectors.' + nullable: true + allowCreateUpdateRemoveTabs: + type: boolean + description: 'If set to true, members can add, update, and remove tabs.' + nullable: true + allowDeleteChannels: + type: boolean + description: 'If set to true, members can delete channels.' + nullable: true + additionalProperties: + type: object + microsoft.graph.teamMessagingSettings: + title: teamMessagingSettings + type: object + properties: + allowChannelMentions: + type: boolean + description: 'If set to true, @channel mentions are allowed.' + nullable: true + allowOwnerDeleteMessages: + type: boolean + description: 'If set to true, owners can delete any message.' + nullable: true + allowTeamMentions: + type: boolean + description: 'If set to true, @team mentions are allowed.' + nullable: true + allowUserDeleteMessages: + type: boolean + description: 'If set to true, users can delete their messages.' + nullable: true + allowUserEditMessages: + type: boolean + description: 'If set to true, users can edit their messages.' + nullable: true + additionalProperties: + type: object + microsoft.graph.teamSpecialization: + title: teamSpecialization + enum: + - none + - educationStandard + - educationClass + - educationProfessionalLearningCommunity + - educationStaff + - healthcareStandard + - healthcareCareCoordination + - unknownFutureValue + type: string + microsoft.graph.teamSummary: + title: teamSummary + type: object + properties: + guestsCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Count of guests in a team. + format: int32 + nullable: true + membersCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Count of members in a team. + format: int32 + nullable: true + ownersCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Count of owners in a team. + format: int32 + nullable: true + additionalProperties: + type: object + microsoft.graph.teamVisibilityType: + title: teamVisibilityType + enum: + - private + - public + - hiddenMembership + - unknownFutureValue + type: string + microsoft.graph.channel: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: channel + type: object + properties: + 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: Read only. Timestamp at which the channel was created. + format: date-time + nullable: true + description: + type: string + description: Optional textual description for the channel. + nullable: true + displayName: + type: string + description: Channel name as it appears to the user in Microsoft Teams. The maximum length is 50 characters. + email: + type: string + description: The email address for sending messages to the channel. Read-only. + nullable: true + isArchived: + type: boolean + description: Indicates whether the channel is archived. Read-only. + nullable: true + isFavoriteByDefault: + type: boolean + description: 'Indicates whether the channel should be marked as recommended for all members of the team to show in their channel list. Note: All recommended channels automatically show in the channels list for education and frontline worker users. The property can only be set programmatically via the Create team method. The default value is false.' + nullable: true + layoutType: + $ref: '#/components/schemas/microsoft.graph.channelLayoutType' + membershipType: + $ref: '#/components/schemas/microsoft.graph.channelMembershipType' + migrationMode: + $ref: '#/components/schemas/microsoft.graph.migrationMode' + moderationSettings: + $ref: '#/components/schemas/microsoft.graph.channelModerationSettings' + originalCreatedDateTime: + 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: Timestamp of the original creation time for the channel. The value is null if the channel never entered migration mode. + format: date-time + nullable: true + summary: + $ref: '#/components/schemas/microsoft.graph.channelSummary' + tenantId: + type: string + description: The ID of the Microsoft Entra tenant. + nullable: true + webUrl: + type: string + description: 'A hyperlink to the channel in Microsoft Teams. This URL is supplied when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.' + nullable: true + allMembers: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.conversationMember' + description: A collection of membership records associated with the channel. It includes both direct and indirect members of shared channels. + x-ms-navigationProperty: true + enabledApps: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.teamsApp' + description: A collection of enabled apps in the channel. + x-ms-navigationProperty: true + filesFolder: + $ref: '#/components/schemas/microsoft.graph.driveItem' + members: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.conversationMember' + description: A collection of membership records associated with the channel. + x-ms-navigationProperty: true + messages: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.chatMessage' + description: A collection of all the messages in the channel. Nullable. + x-ms-navigationProperty: true + planner: + $ref: '#/components/schemas/microsoft.graph.teamsChannelPlanner' + sharedWithTeams: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.sharedWithChannelTeamInfo' + description: A collection of teams with which a channel is shared. + x-ms-navigationProperty: true + tabs: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.teamsTab' + description: A collection of all the tabs in the channel. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.teamsAppInstallation: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: teamsAppInstallation + type: object + properties: + consentedPermissionSet: + $ref: '#/components/schemas/microsoft.graph.teamsAppPermissionSet' + scopeInfo: + $ref: '#/components/schemas/microsoft.graph.teamsAppInstallationScopeInfo' + teamsApp: + $ref: '#/components/schemas/microsoft.graph.teamsApp' + teamsAppDefinition: + $ref: '#/components/schemas/microsoft.graph.teamsAppDefinition' + additionalProperties: + type: object + microsoft.graph.conversationMember: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: conversationMember + type: object + properties: + displayName: + type: string + description: The display name of the user. + nullable: true + roles: + type: array + items: + type: string + nullable: true + description: 'The roles for that user. This property contains additional qualifiers only when relevant - for example, if the member has owner privileges, the roles property contains owner as one of the values. Similarly, if the member is an in-tenant guest, the roles property contains guest as one of the values. A basic member should not have any values specified in the roles property. An Out-of-tenant external member is assigned the owner role.' + visibleHistoryStartDateTime: + 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 timestamp denoting how far back a conversation's history is shared with the conversation member. This property is settable only for members of a chat. + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.teamsAsyncOperation: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: teamsAsyncOperation + type: object + properties: + attemptsCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Number of times the operation was attempted before being marked successful or failed. + format: int32 + 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: Time when the operation was created. + format: date-time + error: + $ref: '#/components/schemas/microsoft.graph.operationError' + lastActionDateTime: + 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: Time when the async operation was last updated. + format: date-time + operationType: + $ref: '#/components/schemas/microsoft.graph.teamsAsyncOperationType' + status: + $ref: '#/components/schemas/microsoft.graph.teamsAsyncOperationStatus' + targetResourceId: + type: string + description: 'The ID of the object that''s created or modified as result of this async operation, typically a team.' + nullable: true + targetResourceLocation: + type: string + description: The location of the object that's created or modified as result of this async operation. This URL should be treated as an opaque value and not parsed into its component paths. + nullable: true + additionalProperties: + type: object + microsoft.graph.user: + allOf: + - $ref: '#/components/schemas/microsoft.graph.directoryObject' + - title: user + type: object + properties: + aboutMe: + type: string + description: A freeform text entry field for users to describe themselves. Requires $select to retrieve. + nullable: true + accountEnabled: + type: boolean + description: 'true if the account is enabled; otherwise, false. This property is required when creating the object. Supports $filter (eq, ne, not, and in).' + nullable: true + ageGroup: + type: string + description: 'Sets the age group of the user. Allowed values: null, Minor, NotAdult, and Adult. For more information, see legal age group property definitions. Supports $filter (eq, ne, not, and in).' + nullable: true + assignedLicenses: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.assignedLicense' + description: 'The licenses that are assigned to the user, including inherited (group-based) licenses. This property doesn''t differentiate between directly assigned and inherited licenses. Use the licenseAssignmentStates property to identify the directly assigned and inherited licenses. Not nullable. Supports $filter (eq, not, /$count eq 0, /$count ne 0).' + assignedPlans: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.assignedPlan' + description: The plans that are assigned to the user. Read-only. Not nullable.Supports $filter (eq and not). + authorizationInfo: + $ref: '#/components/schemas/microsoft.graph.authorizationInfo' + birthday: + 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 birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z Requires $select to retrieve.' + format: date-time + businessPhones: + type: array + items: + type: string + description: 'The telephone numbers for the user. Only one number can be set for this property. Read-only for users synced from on-premises directory. Supports $filter (eq, not, ge, le, startsWith).' + city: + type: string + description: 'The city where the user is located. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + cloudLicensing: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.userCloudLicensing' + cloudRealtimeCommunicationInfo: + $ref: '#/components/schemas/microsoft.graph.cloudRealtimeCommunicationInfo' + companyName: + type: string + description: 'The name of the company the user is associated with. This property can be useful for describing the company that an external user comes from. The maximum length is 64 characters.Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + consentProvidedForMinor: + type: string + description: 'Sets whether consent has been obtained for minors. Allowed values: null, Granted, Denied and NotRequired. Refer to the legal age group property definitions for further information. Supports $filter (eq, ne, not, and in).' + nullable: true + country: + type: string + description: 'The country or region where the user is located; for example, US or UK. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + 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: 'The date and time the user was created in ISO 8601 format and UTC. The value cannot be modified and is automatically populated when the entity is created. Nullable. For on-premises users, the value represents when they were first created in Microsoft Entra ID. Property is null for some users created before June 2018 and on-premises users synced to Microsoft Entra ID before June 2018. Read-only. Supports $filter (eq, ne, not , ge, le, in).' + format: date-time + nullable: true + creationType: + type: string + description: 'Indicates whether the user account was created through one of the following methods: As a regular school or work account (null). As an external account (Invitation). As a local account for an Azure Active Directory B2C tenant (LocalAccount). Through self-service sign-up by an internal user using email verification (EmailVerified). Through self-service sign-up by an external user signing up through a link that is part of a user flow (SelfServiceSignUp). Read-only.Supports $filter (eq, ne, not, and in).' + nullable: true + customSecurityAttributes: + $ref: '#/components/schemas/microsoft.graph.customSecurityAttributeValue' + department: + type: string + description: 'The name of the department where the user works. Maximum length is 64 characters.Supports $filter (eq, ne, not , ge, le, in, and eq on null values).' + nullable: true + deviceEnrollmentLimit: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The limit on the maximum number of devices that the user is permitted to enroll. Allowed values are 5 or 1000. + format: int32 + deviceKeys: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.deviceKey' + displayName: + type: string + description: 'The name displayed in the address book for the user. This value is usually the combination of the user''s first name, middle initial, and last name. This property is required when a user is created, and it cannot be cleared during updates. Maximum length is 256 characters. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values), $orderby, and $search.' + nullable: true + employeeHireDate: + 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 date and time when the user was hired or will start work if there is a future hire. Supports $filter (eq, ne, not , ge, le, in).' + format: date-time + nullable: true + employeeId: + type: string + description: 'The employee identifier assigned to the user by the organization. The maximum length is 16 characters.Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).' + nullable: true + employeeLeaveDateTime: + 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 date and time when the user left or will leave the organization. To read this property, the calling app must be assigned the User-LifeCycleInfo.Read.All permission. To write this property, the calling app must be assigned the User.Read.All and User-LifeCycleInfo.ReadWrite.All permissions. To read this property in delegated scenarios, the admin needs at least one of the following Microsoft Entra roles: Lifecycle Workflows Administrator (least privilege), Global Reader. To write this property in delegated scenarios, the admin needs the Global Administrator role. Supports $filter (eq, ne, not , ge, le, in). For more information, see Configure the employeeLeaveDateTime property for a user.' + format: date-time + nullable: true + employeeOrgData: + $ref: '#/components/schemas/microsoft.graph.employeeOrgData' + employeeType: + type: string + description: 'Captures enterprise worker type. For example, Employee, Contractor, Consultant, or Vendor. Supports $filter (eq, ne, not , ge, le, in, startsWith).' + nullable: true + externalUserState: + type: string + description: 'For an external user invited to the tenant using the invitation API, this property represents the invited user''s invitation status. For invited users, the state can be PendingAcceptance or Accepted, or null for all other users. Supports $filter (eq, ne, not , in).' + nullable: true + externalUserStateChangeDateTime: + type: string + description: 'Shows the timestamp for the latest change to the externalUserState property. Supports $filter (eq, ne, not , in).' + nullable: true + faxNumber: + type: string + description: 'The fax number of the user. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).' + nullable: true + givenName: + type: string + description: 'The given name (first name) of the user. Maximum length is 64 characters. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).' + nullable: true + hireDate: + 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 hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Requires $select to retrieve. Note: This property is specific to SharePoint Online. We recommend using the native employeeHireDate property to set and update hire date values using Microsoft Graph APIs.' + format: date-time + identities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.objectIdentity' + description: 'Represents the identities that can be used to sign in to this user account. An identity can be provided by Microsoft (also known as a local account), by organizations, or by social identity providers such as Facebook, Google, and Microsoft and tied to a user account. It may contain multiple items with the same signInType value. Supports $filter (eq) with limitations.' + identityGovernance: + $ref: '#/components/schemas/microsoft.graph.identityGovernanceUserSettings' + identityParentId: + type: string + description: 'The object ID of the parent identity for agent users. Always null for regular user accounts. For agentUser resources, this property references the object ID of the associated agent identity.' + nullable: true + imAddresses: + type: array + items: + type: string + nullable: true + description: 'The instant message voice-over IP (VOIP) session initiation protocol (SIP) addresses for the user. Read-only. Supports $filter (eq, not, ge, le, startsWith).' + infoCatalogs: + type: array + items: + type: string + description: 'Identifies the info segments assigned to the user. Supports $filter (eq, not, ge, le, startsWith).' + interests: + type: array + items: + type: string + nullable: true + description: A list for users to describe their interests. Requires $select to retrieve. + isLicenseReconciliationNeeded: + type: boolean + description: Indicates whether the user is pending an exchange mailbox license assignment. Read-only. Supports $filter (eq where true only). + nullable: true + isManagementRestricted: + type: boolean + description: 'true if the user is a member of a restricted management administrative unit. If not set, the default value is null and the default behavior is false. Read-only. To manage a user who is a member of a restricted management administrative unit, the administrator or calling app must be assigned a Microsoft Entra role at the scope of the restricted management administrative unit.' + nullable: true + isResourceAccount: + type: boolean + description: Do not use – reserved for future use. + nullable: true + jobTitle: + type: string + description: 'The user''s job title. Maximum length is 128 characters. Supports $filter (eq, ne, not , ge, le, in, startsWith, and eq on null values).' + nullable: true + lastPasswordChangeDateTime: + 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: 'When this Microsoft Entra user last changed their password or when their password was created, whichever date the latest action was performed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Requires $select to retrieve.' + format: date-time + nullable: true + legalAgeGroupClassification: + type: string + description: 'Used by enterprise applications to determine the legal age group of the user. This property is read-only and calculated based on ageGroup and consentProvidedForMinor properties. Allowed values: null, Undefined, MinorWithOutParentalConsent, MinorWithParentalConsent, MinorNoParentalConsentRequired, NotAdult, and Adult. For more information, see legal age group property definitions. Requires $select to retrieve.' + nullable: true + licenseAssignmentStates: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.licenseAssignmentState' + description: State of license assignments for this user. It also indicates licenses that are directly assigned and the ones the user inherited through group memberships. Read-only. Requires $select to retrieve. + mail: + type: string + description: 'The SMTP address for the user, for example, admin@contoso.com. Changes to this property also update the user''s proxyAddresses collection to include the value as an SMTP address. This property can''t contain accent characters. NOTE: We don''t recommend updating this property for Azure AD B2C user profiles. Use the otherMails property instead. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith, and eq on null values).' + nullable: true + mailboxSettings: + $ref: '#/components/schemas/microsoft.graph.mailboxSettings' + mailNickname: + type: string + description: 'The mail alias for the user. This property must be specified when a user is created. Maximum length is 64 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + mobilePhone: + type: string + description: 'The primary cellular telephone number for the user. Read-only for users synced from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values) and $search.' + nullable: true + mySite: + type: string + description: The URL for the user's site. Requires $select to retrieve. + nullable: true + officeLocation: + type: string + description: 'The office location in the user''s place of business. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + onPremisesDistinguishedName: + type: string + description: Contains the on-premises Active Directory distinguished name or DN. + nullable: true + onPremisesDomainName: + type: string + description: 'Contains the on-premises domainFQDN, also called dnsDomainName synchronized from the on-premises directory.' + nullable: true + onPremisesExtensionAttributes: + $ref: '#/components/schemas/microsoft.graph.onPremisesExtensionAttributes' + onPremisesImmutableId: + type: string + description: 'This property associates an on-premises Active Directory user account to their Microsoft Entra user object. This property must be specified when creating a new user account in the Graph if you''re using a federated domain for the user''s userPrincipalName (UPN) property. Note: The $ and _ characters can''t be used when specifying this property. Supports $filter (eq, ne, not, ge, le, in).' + nullable: true + onPremisesLastSyncDateTime: + 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: 'Indicates the last time at which the object was synced with the on-premises directory; for example: ''2013-02-16T03:04:54Z''. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only. Supports $filter (eq, ne, not, ge, le, in).' + format: date-time + nullable: true + onPremisesProvisioningErrors: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onPremisesProvisioningError' + description: 'Errors when using Microsoft synchronization product during provisioning. Supports $filter (eq, not, ge, le).' + onPremisesSamAccountName: + type: string + description: 'Contains the on-premises sAMAccountName synchronized from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith).' + nullable: true + onPremisesSecurityIdentifier: + type: string + description: 'Contains the on-premises security identifier (SID) for the user synchronized from on-premises to the cloud. Must be in the format of SID, such as ''S-1-5-21-1180699209-877415012-3182824384-1006''. Supports $filter (eq including on null values).' + nullable: true + onPremisesSipInfo: + $ref: '#/components/schemas/microsoft.graph.onPremisesSipInfo' + onPremisesSyncEnabled: + type: boolean + description: 'true if this user object is currently being synced from an on-premises Active Directory (AD); otherwise, the user isn''t being synced and can be managed in Microsoft Entra ID. Read-only. Supports $filter (eq, ne, not, in, and eq on null values).' + nullable: true + onPremisesUserPrincipalName: + type: string + description: 'Contains the on-premises userPrincipalName synchronized from the on-premises directory. Supports $filter (eq, ne, not, ge, le, in, startsWith).' + nullable: true + otherMails: + type: array + items: + type: string + description: 'A list of additional email addresses for the user; for example: [''bob@contoso.com'', ''Robert@fabrikam.com'']. Can store up to 250 values, each with a limit of 250 characters. NOTE: This property can''t contain accent characters.Supports $filter (eq, not, ge, le, in, startsWith, endsWith, /$count eq 0, /$count ne 0).' + passwordPolicies: + type: string + description: 'Specifies password policies for the user. This value is an enumeration with one possible value being DisableStrongPassword, which allows weaker passwords than the default policy to be specified. DisablePasswordExpiration can also be specified. The two may be specified together; for example: DisablePasswordExpiration, DisableStrongPassword. For more information on the default password policies, see Microsoft Entra password policies. Supports $filter (ne, not, and eq on null values).' + nullable: true + passwordProfile: + $ref: '#/components/schemas/microsoft.graph.passwordProfile' + pastProjects: + type: array + items: + type: string + nullable: true + description: A list for users to enumerate their past projects. Requires $select to retrieve. + postalCode: + type: string + description: 'The postal code for the user''s postal address. The postal code is specific to the user''s country/region. In the United States of America, this attribute contains the ZIP code. Maximum length is 40 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + preferredDataLocation: + type: string + description: 'The preferred data location for the user. For more information, see OneDrive Online Multi-Geo.' + nullable: true + preferredLanguage: + type: string + description: 'The preferred language for the user. The preferred language format is based on RFC 4646. The name combines an ISO 639 two-letter lowercase culture code associated with the language and an ISO 3166 two-letter uppercase subculture code associated with the country or region. Example: ''en-US'', or ''es-ES''. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + preferredName: + type: string + description: The preferred name for the user. Not Supported. This attribute returns an empty string.Requires $select to retrieve. + nullable: true + print: + $ref: '#/components/schemas/microsoft.graph.userPrint' + provisionedPlans: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.provisionedPlan' + description: 'The plans that are provisioned for the user. Read-only. Not nullable. Supports $filter (eq, not, ge, le).' + proxyAddresses: + type: array + items: + type: string + description: 'For example: [''SMTP: bob@contoso.com'', ''smtp: bob@sales.contoso.com'']. Changes to the mail property also update this collection to include the value as an SMTP address. For more information, see mail and proxyAddresses properties. The proxy address prefixed with SMTP (capitalized) is the primary proxy address, while the ones prefixed with smtp are the secondary proxy addresses. For Azure AD B2C accounts, this property has a limit of 10 unique addresses. Read-only in Microsoft Graph; you can update this property only through the Microsoft 365 admin center. Not nullable. Supports $filter (eq, not, ge, le, startsWith, endsWith, /$count eq 0, /$count ne 0).' + refreshTokensValidFromDateTime: + 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: 'Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph). If it happens, the application must acquire a new refresh token by requesting the authorized endpoint. Read-only. Use invalidateAllRefreshTokens to reset.' + format: date-time + nullable: true + responsibilities: + type: array + items: + type: string + nullable: true + description: A list for the user to enumerate their responsibilities. Requires $select to retrieve. + schools: + type: array + items: + type: string + nullable: true + description: A list for the user to enumerate the schools they have attended. Requires $select to retrieve. + securityIdentifier: + type: string + description: 'Security identifier (SID) of the user, used in Windows scenarios. Read-only. Returned by default. Supports $select and $filter (eq, not, ge, le, startsWith).' + nullable: true + serviceProvisioningErrors: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.serviceProvisioningError' + description: 'Errors published by a federated service describing a nontransient, service-specific error regarding the properties or link from a user object.' + showInAddressList: + type: boolean + description: Do not use in Microsoft Graph. Manage this property through the Microsoft 365 admin center instead. Represents whether the user should be included in the Outlook global address list. See Known issue. + nullable: true + signInActivity: + $ref: '#/components/schemas/microsoft.graph.signInActivity' + signInSessionsValidFromDateTime: + 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: 'Any refresh tokens or sessions tokens (session cookies) issued before this time are invalid, and applications get an error when using an invalid refresh or sessions token to acquire a delegated access token (to access APIs such as Microsoft Graph). If this happens, the application must acquire a new refresh token by requesting the authorized endpoint. Read-only. Use revokeSignInSessions to reset.' + format: date-time + nullable: true + skills: + type: array + items: + type: string + nullable: true + description: A list for the user to enumerate their skills. Requires $select to retrieve. + state: + type: string + description: 'The state or province in the user''s address. Maximum length is 128 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + streetAddress: + type: string + description: 'The street address of the user''s place of business. Maximum length is 1024 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + surname: + type: string + description: 'The user''s surname (family name or last name). Maximum length is 64 characters. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + usageLocation: + type: string + description: 'A two-letter country code (ISO standard 3166). Required for users that are assigned licenses due to legal requirements to check for availability of services in countries. Examples include: US, JP, and GB. Not nullable. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq on null values).' + nullable: true + userPrincipalName: + type: string + description: 'The user principal name (UPN) of the user. The UPN is an Internet-style sign-in name for the user based on the Internet standard RFC 822. By convention, this should map to the user''s email name. The general format is alias@domain, where the domain must be present in the tenant''s verified domain collection. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization.NOTE: This property can''t contain accent characters. Only the following characters are allowed A - Z, a - z, 0 - 9, '' . - _ ! # ^ ~. For the complete list of allowed characters, see username policies. Supports $filter (eq, ne, not, ge, le, in, startsWith, endsWith) and $orderby.' + nullable: true + userType: + type: string + description: 'A String value that can be used to classify user types in your directory. The possible values are Member and Guest. Supports $filter (eq, ne, not, in, and eq on null values). NOTE: For more information about the permissions for member and guest users, see What are the default user permissions in Microsoft Entra ID?' + nullable: true + activities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.userActivity' + description: The user's activities across devices. Read-only. Nullable. + x-ms-navigationProperty: true + adhocCalls: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.adhocCall' + description: Ad hoc calls associated with the user. Read-only. Nullable. + x-ms-navigationProperty: true + agreementAcceptances: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.agreementAcceptance' + description: The user's terms of use acceptance statuses. Read-only. Nullable. + x-ms-navigationProperty: true + analytics: + $ref: '#/components/schemas/microsoft.graph.userAnalytics' + appConsentRequestsForApproval: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.appConsentRequest' + x-ms-navigationProperty: true + appRoleAssignedResources: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.servicePrincipal' + x-ms-navigationProperty: true + appRoleAssignments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.appRoleAssignment' + description: Represents the app roles a user has been granted for an application. Supports $expand. + x-ms-navigationProperty: true + approvals: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.approval' + x-ms-navigationProperty: true + authentication: + $ref: '#/components/schemas/microsoft.graph.authentication' + calendar: + $ref: '#/components/schemas/microsoft.graph.calendar' + calendarGroups: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.calendarGroup' + description: The user's calendar groups. Read-only. Nullable. + x-ms-navigationProperty: true + calendars: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.calendar' + description: The user's calendars. Read-only. Nullable. + x-ms-navigationProperty: true + calendarView: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: The calendar view for the calendar. Read-only. Nullable. + x-ms-navigationProperty: true + chats: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.chat' + x-ms-navigationProperty: true + cloudClipboard: + $ref: '#/components/schemas/microsoft.graph.cloudClipboardRoot' + cloudPCs: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudPC' + description: The user's Cloud PCs. Read-only. Nullable. + x-ms-navigationProperty: true + communications: + $ref: '#/components/schemas/microsoft.graph.userCloudCommunication' + contactFolders: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contactFolder' + description: The user's contacts folders. Read-only. Nullable. + x-ms-navigationProperty: true + contacts: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contact' + description: The user's contacts. Read-only. Nullable. + x-ms-navigationProperty: true + createdObjects: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: Directory objects that the user created. Read-only. Nullable. + x-ms-navigationProperty: true + dataSecurityAndGovernance: + $ref: '#/components/schemas/microsoft.graph.userDataSecurityAndGovernance' + deviceEnrollmentConfigurations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.deviceEnrollmentConfiguration' + description: Get enrollment configurations targeted to the user + x-ms-navigationProperty: true + deviceManagementTroubleshootingEvents: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.deviceManagementTroubleshootingEvent' + description: The list of troubleshooting events for this user. + x-ms-navigationProperty: true + devices: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.device' + x-ms-navigationProperty: true + directReports: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: The users and contacts that report to the user. (The users and contacts with their manager property set to this user.) Read-only. Nullable. Supports $expand. + x-ms-navigationProperty: true + drive: + $ref: '#/components/schemas/microsoft.graph.drive' + drives: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.drive' + description: A collection of drives available for this user. Read-only. + x-ms-navigationProperty: true + employeeExperience: + $ref: '#/components/schemas/microsoft.graph.employeeExperienceUser' + events: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.event' + description: The user's events. The default is to show events under the Default Calendar. Read-only. Nullable. + x-ms-navigationProperty: true + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the user. Supports $expand. Nullable. + x-ms-navigationProperty: true + followedSites: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.site' + x-ms-navigationProperty: true + inferenceClassification: + $ref: '#/components/schemas/microsoft.graph.inferenceClassification' + informationProtection: + $ref: '#/components/schemas/microsoft.graph.informationProtection' + insights: + $ref: '#/components/schemas/microsoft.graph.itemInsights' + invitedBy: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + joinedGroups: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.group' + x-ms-navigationProperty: true + joinedTeams: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.team' + description: The Microsoft Teams teams the user is a member of. Read-only. Nullable. + x-ms-navigationProperty: true + licenseDetails: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.licenseDetails' + x-ms-navigationProperty: true + mailFolders: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.mailFolder' + description: The user's mail folders. Read-only. Nullable. + x-ms-navigationProperty: true + managedAppLogCollectionRequests: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.managedAppLogCollectionRequest' + description: Zero or more log collection requests triggered for the user. + x-ms-navigationProperty: true + managedAppRegistrations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.managedAppRegistration' + description: Zero or more managed app registrations that belong to the user. + x-ms-navigationProperty: true + managedDevices: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.managedDevice' + description: The managed devices associated with the user. + x-ms-navigationProperty: true + manager: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + memberOf: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'The groups, directory roles, and administrative units that the user is a member of. Read-only. Nullable. Supports $expand.' + x-ms-navigationProperty: true + messages: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.message' + description: The messages in a mailbox or folder. Read-only. Nullable. + x-ms-navigationProperty: true + mobileAppIntentAndStates: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.mobileAppIntentAndState' + description: The list of troubleshooting events for this user. + x-ms-navigationProperty: true + mobileAppTroubleshootingEvents: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.mobileAppTroubleshootingEvent' + description: The list of mobile app troubleshooting events for this user. + x-ms-navigationProperty: true + notifications: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.notification' + x-ms-navigationProperty: true + oauth2PermissionGrants: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.oAuth2PermissionGrant' + x-ms-navigationProperty: true + onenote: + $ref: '#/components/schemas/microsoft.graph.onenote' + onlineMeetings: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.onlineMeeting' + description: 'Information about a meeting, including the URL used to join a meeting, the attendees list, and the description.' + x-ms-navigationProperty: true + onPremisesSyncBehavior: + $ref: '#/components/schemas/microsoft.graph.onPremisesSyncBehavior' + outlook: + $ref: '#/components/schemas/microsoft.graph.outlookUser' + ownedDevices: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: Devices owned by the user. Read-only. Nullable. Supports $expand. + x-ms-navigationProperty: true + ownedObjects: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'Directory objects owned by the user. Read-only. Nullable. Supports $expand, $select nested in $expand, and $filter (/$count eq 0, /$count ne 0, /$count eq 1, /$count ne 1).' + x-ms-navigationProperty: true + pendingAccessReviewInstances: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.accessReviewInstance' + description: Navigation property to get a list of access reviews pending approval by the reviewer. + x-ms-navigationProperty: true + people: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.person' + description: 'Read-only. The most relevant people to the user. The collection is ordered by their relevance to the user, which is determined by the user''s communication, collaboration, and business relationships. A person aggregates information from mail, contacts, and social networks.' + x-ms-navigationProperty: true + permissionGrants: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.resourceSpecificPermissionGrant' + description: List all resource-specific permission grants of a user. + x-ms-navigationProperty: true + photo: + $ref: '#/components/schemas/microsoft.graph.profilePhoto' + photos: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.profilePhoto' + description: The collection of the user's profile photos in different sizes. Read-only. + x-ms-navigationProperty: true + planner: + $ref: '#/components/schemas/microsoft.graph.plannerUser' + presence: + $ref: '#/components/schemas/microsoft.graph.presence' + profile: + $ref: '#/components/schemas/microsoft.graph.profile' + registeredDevices: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: Devices that are registered for the user. Read-only. Nullable. Supports $expand and returns up to 100 objects. + x-ms-navigationProperty: true + scopedRoleMemberOf: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.scopedRoleMembership' + description: The scoped-role administrative unit memberships for this user. Read-only. Nullable. + x-ms-navigationProperty: true + security: + $ref: '#/components/schemas/microsoft.graph.security.security' + settings: + $ref: '#/components/schemas/microsoft.graph.userSettings' + solutions: + $ref: '#/components/schemas/microsoft.graph.userSolutionRoot' + sponsors: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'The users and groups responsible for this guest user''s privileges in the tenant and keep the guest user''s information and access updated. (HTTP Methods: GET, POST, DELETE.). Supports $expand.' + x-ms-navigationProperty: true + teamwork: + $ref: '#/components/schemas/microsoft.graph.userTeamwork' + todo: + $ref: '#/components/schemas/microsoft.graph.todo' + transitiveMemberOf: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: 'The groups, including nested groups and directory roles that a user is a member of. Nullable.' + x-ms-navigationProperty: true + transitiveReports: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: The transitive reports for a user. Read-only. + x-ms-navigationProperty: true + usageRights: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.usageRight' + description: Represents the usage rights a user has been granted. + x-ms-navigationProperty: true + virtualEvents: + $ref: '#/components/schemas/microsoft.graph.userVirtualEventsRoot' + windowsInformationProtectionDeviceRegistrations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.windowsInformationProtectionDeviceRegistration' + description: Zero or more WIP device registrations that belong to the user. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.schedule: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: schedule + type: object + properties: + activitiesIncludedWhenCopyingShiftsEnabled: + type: boolean + description: 'Indicates whether copied shifts should include the activities. This property will be removed by November 20, 2027. Use isActivitiesIncludedWhenCopyingShiftsEnabled instead. activitiesIncludedWhenCopyingShiftsEnabled and isActivitiesIncludedWhenCopyingShiftsEnabled always have the same value, so setting one automatically sets the value for the other. If both are included in the request with different values, the value for isActivitiesIncludedWhenCopyingShiftsEnabled takes precedence.' + nullable: true + enabled: + type: boolean + description: Indicates whether the schedule is enabled for the team. Required. + nullable: true + isActivitiesIncludedWhenCopyingShiftsEnabled: + type: boolean + description: Indicates whether copied shifts include activities from the original shift. + nullable: true + isCrossLocationShiftRequestApprovalRequired: + type: boolean + description: Indicates whether approval is required by a manager of this schedule for cross location shift requests. + nullable: true + isCrossLocationShiftsEnabled: + type: boolean + description: Indicates whether the cross-location marketplace feature is enabled for this schedule. + nullable: true + offerShiftRequestsEnabled: + type: boolean + description: Indicates whether offer shift requests are enabled for the schedule. + nullable: true + openShiftsEnabled: + type: boolean + description: Indicates whether open shifts are enabled for the schedule. + nullable: true + provisionStatus: + $ref: '#/components/schemas/microsoft.graph.operationStatus' + provisionStatusCode: + type: string + description: Additional information about why schedule provisioning failed. + nullable: true + readOnly: true + startDayOfWeek: + $ref: '#/components/schemas/microsoft.graph.dayOfWeek' + swapShiftsRequestsEnabled: + type: boolean + description: Indicates whether swap shifts requests are enabled for the schedule. + nullable: true + timeClockEnabled: + type: boolean + description: Indicates whether time clock is enabled for the schedule. + nullable: true + timeClockSettings: + $ref: '#/components/schemas/microsoft.graph.timeClockSettings' + timeOffRequestsEnabled: + type: boolean + description: Indicates whether time off requests are enabled for the schedule. + nullable: true + timeZone: + type: string + description: Indicates the time zone of the schedule team using tz database format. Required. + nullable: true + workforceIntegrationIds: + type: array + items: + type: string + nullable: true + description: The IDs for the workforce integrations associated with this schedule. + dayNotes: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.dayNote' + description: The day notes in the schedule. + x-ms-navigationProperty: true + offerShiftRequests: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.offerShiftRequest' + description: The offer requests for shifts in the schedule. + x-ms-navigationProperty: true + openShiftChangeRequests: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.openShiftChangeRequest' + description: The open shift requests in the schedule. + x-ms-navigationProperty: true + openShifts: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.openShift' + description: The set of open shifts in a scheduling group in the schedule. + x-ms-navigationProperty: true + schedulingGroups: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.schedulingGroup' + description: The logical grouping of users in the schedule (usually by role). + x-ms-navigationProperty: true + shifts: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.shift' + description: The shifts in the schedule. + x-ms-navigationProperty: true + shiftsRoleDefinitions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.shiftsRoleDefinition' + description: The definitions of the roles in the schedule. + x-ms-navigationProperty: true + swapShiftsChangeRequests: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.swapShiftsChangeRequest' + description: The swap requests for shifts in the schedule. + x-ms-navigationProperty: true + timeCards: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.timeCard' + description: The time cards in the schedule. + x-ms-navigationProperty: true + timeOffReasons: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.timeOffReason' + description: The set of reasons for a time off in the schedule. + x-ms-navigationProperty: true + timeOffRequests: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.timeOffRequest' + description: The time off requests in the schedule. + x-ms-navigationProperty: true + timesOff: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.timeOff' + description: The instances of times off in the schedule. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.teamworkTag: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: teamworkTag + type: object + properties: + description: + type: string + description: Tag description as it appears to the user in Microsoft Teams. A teamworkTag can't have more than 200 teamworkTagMembers. + nullable: true + displayName: + type: string + description: Tag name as it appears to the user in Microsoft Teams. + nullable: true + memberCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of users assigned to the tag. + format: int32 + nullable: true + tagType: + $ref: '#/components/schemas/microsoft.graph.teamworkTagType' + teamId: + type: string + description: ID of the team in which the tag is defined. + nullable: true + members: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.teamworkTagMember' + description: Users assigned to the tag. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.teamsTemplate: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: teamsTemplate + type: object + additionalProperties: + type: object + microsoft.graph.teamTemplateDefinition: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: teamTemplateDefinition + type: object + properties: + audience: + $ref: '#/components/schemas/microsoft.graph.teamTemplateAudience' + categories: + type: array + items: + type: string + nullable: true + description: The assigned categories for the team template. + description: + type: string + description: A brief description of the team template as it will appear to the users in Microsoft Teams. + nullable: true + displayName: + type: string + description: The user defined name of the team template. + nullable: true + iconUrl: + type: string + description: The icon url for the team template. + nullable: true + languageTag: + type: string + description: Language the template is available in. + nullable: true + lastModifiedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + lastModifiedDateTime: + 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 date time of when the team template was last modified. + format: date-time + nullable: true + parentTemplateId: + type: string + description: The templateId for the team template + nullable: true + publisherName: + type: string + description: The organization which published the team template. + nullable: true + shortDescription: + type: string + description: A short-description of the team template as it will appear to the users in Microsoft Teams. + nullable: true + teamDefinition: + $ref: '#/components/schemas/microsoft.graph.team' + additionalProperties: + type: object + microsoft.graph.post: + allOf: + - $ref: '#/components/schemas/microsoft.graph.outlookItem' + - title: post + type: object + properties: + body: + $ref: '#/components/schemas/microsoft.graph.itemBody' + conversationId: + type: string + description: Unique ID of the conversation. Read-only. + nullable: true + conversationThreadId: + type: string + description: Unique ID of the conversation thread. Read-only. + nullable: true + from: + $ref: '#/components/schemas/microsoft.graph.recipient' + hasAttachments: + type: boolean + description: Indicates whether the post has at least one attachment. This is a default property. + importance: + $ref: '#/components/schemas/microsoft.graph.importance' + newParticipants: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.recipient' + description: Conversation participants that were added to the thread as part of this post. + receivedDateTime: + 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: 'Specifies when the post was received. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + sender: + $ref: '#/components/schemas/microsoft.graph.recipient' + attachments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.attachment' + description: 'The collection of fileAttachment, itemAttachment, and referenceAttachment attachments for the post. Read-only. Nullable. Supports $expand.' + x-ms-navigationProperty: true + extensions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.extension' + description: The collection of open extensions defined for the post. Read-only. Nullable. Supports $expand. + x-ms-navigationProperty: true + inReplyTo: + $ref: '#/components/schemas/microsoft.graph.post' + mentions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.mention' + x-ms-navigationProperty: true + multiValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.multiValueLegacyExtendedProperty' + description: The collection of multi-value extended properties defined for the post. Read-only. Nullable. + x-ms-navigationProperty: true + singleValueExtendedProperties: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.singleValueLegacyExtendedProperty' + description: The collection of single-value extended properties defined for the post. Read-only. Nullable. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.cloudLicensing.allotment: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: allotment + type: object + properties: + allottedUnits: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of licenses contained within the allotment. Not nullable. Read-only. + format: int32 + assignableTo: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.assigneeTypes' + consumedUnits: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of licenses that are currently consumed by assignments from this allotment. Not nullable. Read-only. + format: int32 + services: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.service' + description: The list of services that might be enabled or disabled for assignments from this allotment. Not nullable. Read-only. + skuId: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + description: Unique identifier (GUID) for the service SKU that is equal to the skuId property on the related subscribedSku object. Read-only. Supports $filter. + format: uuid + nullable: true + skuPartNumber: + type: string + description: 'Unique SKU display name that is equal to the skuPartNumber on the related subscribedSku object; for example, AAD_Premium. Read-only.' + nullable: true + subscriptions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.subscription' + description: Basic information about the subscriptions that supports this allotment. + assignments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.assignment' + description: The list of license assignments that consume licenses from this allotment. Not nullable. + x-ms-navigationProperty: true + waitingMembers: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.waitingMember' + description: List of over-assigned users who are in the waiting room for an allotment due to license capacity limits. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.cloudLicensing.service: + title: service + type: object + properties: + assignableTo: + $ref: '#/components/schemas/microsoft.graph.cloudLicensing.assigneeTypes' + planId: + pattern: '^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$' + type: string + description: The unique identifier of the service plan that is equal to the servicePlanId property on the related servicePlanInfo objects. + format: uuid + planName: + type: string + description: The name of the service plan that is equal to the servicePlanName property on the related servicePlanInfo objects. + nullable: true + additionalProperties: + type: object + microsoft.graph.calendarRoleType: + title: calendarRoleType + enum: + - none + - freeBusyRead + - limitedRead + - read + - write + - delegateWithoutPrivateEventAccess + - delegateWithPrivateEventAccess + - custom + type: string + microsoft.graph.attendeeBase: + allOf: + - $ref: '#/components/schemas/microsoft.graph.recipient' + - title: attendeeBase + type: object + properties: + type: + $ref: '#/components/schemas/microsoft.graph.attendeeType' + additionalProperties: + type: object + microsoft.graph.timeSlot: + title: timeSlot + type: object + properties: + end: + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + start: + $ref: '#/components/schemas/microsoft.graph.dateTimeTimeZone' + additionalProperties: + type: object + microsoft.graph.bodyType: + title: bodyType + enum: + - text + - html + type: string + microsoft.graph.physicalAddress: + title: physicalAddress + type: object + properties: + city: + type: string + description: The city. + nullable: true + countryOrRegion: + type: string + description: 'The country or region. It''s a free-format string value, for example, ''United States''.' + nullable: true + postalCode: + type: string + description: The postal code. + nullable: true + postOfficeBox: + type: string + description: The post office box number. + nullable: true + state: + type: string + description: The state. + nullable: true + street: + type: string + description: The street. + nullable: true + type: + $ref: '#/components/schemas/microsoft.graph.physicalAddressType' + additionalProperties: + type: object + microsoft.graph.outlookGeoCoordinates: + title: outlookGeoCoordinates + type: object + properties: + accuracy: + type: number + description: 'The accuracy of the latitude and longitude. As an example, the accuracy can be measured in meters, such as the latitude and longitude are accurate to within 50 meters.' + format: double + nullable: true + altitude: + type: number + description: The altitude of the location. + format: double + nullable: true + altitudeAccuracy: + type: number + description: The accuracy of the altitude. + format: double + nullable: true + latitude: + type: number + description: The latitude of the location. + format: double + nullable: true + longitude: + type: number + description: The longitude of the location. + format: double + nullable: true + additionalProperties: + type: object + microsoft.graph.locationType: + title: locationType + enum: + - default + - conferenceRoom + - homeAddress + - businessAddress + - geoCoordinates + - streetAddress + - hotel + - restaurant + - localBusiness + - postalAddress + type: string + microsoft.graph.locationUniqueIdType: + title: locationUniqueIdType + enum: + - unknown + - locationStore + - directory + - private + - bing + type: string + microsoft.graph.phone: + title: phone + type: object + properties: + number: + type: string + description: The phone number. + nullable: true + type: + $ref: '#/components/schemas/microsoft.graph.phoneType' + additionalProperties: + type: object + microsoft.graph.recurrencePattern: + title: recurrencePattern + type: object + properties: + dayOfMonth: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The day of the month on which the event occurs. Required if type is absoluteMonthly or absoluteYearly. + format: int32 + daysOfWeek: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.dayOfWeek' + description: 'A collection of the days of the week on which the event occurs. The possible values are: sunday, monday, tuesday, wednesday, thursday, friday, saturday. If type is relativeMonthly or relativeYearly, and daysOfWeek specifies more than one day, the event falls on the first day that satisfies the pattern. Required if type is weekly, relativeMonthly, or relativeYearly.' + firstDayOfWeek: + $ref: '#/components/schemas/microsoft.graph.dayOfWeek' + index: + $ref: '#/components/schemas/microsoft.graph.weekIndex' + interval: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'The number of units between occurrences, where units can be in days, weeks, months, or years, depending on the type. Required.' + format: int32 + month: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The month in which the event occurs. This is a number from 1 to 12. + format: int32 + type: + $ref: '#/components/schemas/microsoft.graph.recurrencePatternType' + additionalProperties: + type: object + microsoft.graph.recurrenceRange: + title: recurrenceRange + type: object + properties: + endDate: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$' + type: string + description: 'The date to stop applying the recurrence pattern. Depending on the recurrence pattern of the event, the last occurrence of the meeting may not be this date. Required if type is endDate.' + format: date + nullable: true + numberOfOccurrences: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of times to repeat the event. Required and must be positive if type is numbered. + format: int32 + recurrenceTimeZone: + type: string + description: 'Time zone for the startDate and endDate properties. Optional. If not specified, the time zone of the event is used.' + nullable: true + startDate: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$' + type: string + description: 'The date to start applying the recurrence pattern. The first occurrence of the meeting may be this date or later, depending on the recurrence pattern of the event. Must be the same value as the start property of the recurring event. Required.' + format: date + nullable: true + type: + $ref: '#/components/schemas/microsoft.graph.recurrenceRangeType' + additionalProperties: + type: object + microsoft.graph.responseType: + title: responseType + enum: + - none + - organizer + - tentativelyAccepted + - accepted + - declined + - notResponded + type: string + microsoft.graph.itemReference: + title: itemReference + type: object + properties: + driveId: + type: string + description: Unique identifier of the drive instance that contains the driveItem. Only returned if the item is located in a drive. Read-only. + nullable: true + driveType: + type: string + description: Identifies the type of drive. Only returned if the item is located in a drive. See drive resource for values. + nullable: true + id: + type: string + description: Unique identifier of the driveItem in the drive or a listItem in a list. Read-only. + nullable: true + name: + type: string + description: The name of the item being referenced. Read-only. + nullable: true + path: + type: string + description: Percent-encoded path that can be used to navigate to the item. Read-only. + nullable: true + shareId: + type: string + description: A unique identifier for a shared resource that can be accessed via the Shares API. + nullable: true + sharepointIds: + $ref: '#/components/schemas/microsoft.graph.sharepointIds' + siteId: + type: string + description: 'For OneDrive for Business and SharePoint, this property represents the ID of the site that contains the parent document library of the driveItem resource or the parent list of the listItem resource. The value is the same as the id property of that site resource. It''s an opaque string that consists of three identifiers of the site. For OneDrive, this property isn''t populated.' + nullable: true + additionalProperties: + type: object + microsoft.graph.identity: + title: identity + type: object + properties: + displayName: + type: string + description: 'The display name of the identity. For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don''t show up as changed when using delta.' + nullable: true + id: + type: string + description: 'Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that''s subject to review.' + nullable: true + additionalProperties: + type: object + microsoft.graph.storagePlanInformation: + title: storagePlanInformation + type: object + properties: + upgradeAvailable: + type: boolean + description: Indicates if there are higher storage quota plans available. Read-only. + nullable: true + additionalProperties: + type: object + microsoft.graph.itemActionSet: + title: itemActionSet + type: object + properties: + comment: + $ref: '#/components/schemas/microsoft.graph.commentAction' + create: + $ref: '#/components/schemas/microsoft.graph.createAction' + delete: + $ref: '#/components/schemas/microsoft.graph.deleteAction' + edit: + $ref: '#/components/schemas/microsoft.graph.editAction' + mention: + $ref: '#/components/schemas/microsoft.graph.mentionAction' + move: + $ref: '#/components/schemas/microsoft.graph.moveAction' + rename: + $ref: '#/components/schemas/microsoft.graph.renameAction' + restore: + $ref: '#/components/schemas/microsoft.graph.restoreAction' + share: + $ref: '#/components/schemas/microsoft.graph.shareAction' + version: + $ref: '#/components/schemas/microsoft.graph.versionAction' + additionalProperties: + type: object + microsoft.graph.itemActivityTimeSet: + title: itemActivityTimeSet + type: object + properties: + lastRecordedDateTime: + 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 + format: date-time + nullable: true + observedDateTime: + 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: When the activity was observed to take place. + format: date-time + nullable: true + recordedDateTime: + 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: When the observation was recorded on the service. + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.listItem: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItem' + - title: listItem + type: object + properties: + contentType: + $ref: '#/components/schemas/microsoft.graph.contentTypeInfo' + deleted: + $ref: '#/components/schemas/microsoft.graph.deleted' + sharepointIds: + $ref: '#/components/schemas/microsoft.graph.sharepointIds' + activities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.itemActivityOLD' + description: The list of recent activities that took place on this item. + x-ms-navigationProperty: true + analytics: + $ref: '#/components/schemas/microsoft.graph.itemAnalytics' + documentSetVersions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.documentSetVersion' + description: Version information for a document set version created by a user. + x-ms-navigationProperty: true + driveItem: + $ref: '#/components/schemas/microsoft.graph.driveItem' + fields: + $ref: '#/components/schemas/microsoft.graph.fieldValueSet' + permissions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.permission' + description: The set of permissions for the item. Read-only. Nullable. + x-ms-navigationProperty: true + versions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.listItemVersion' + description: The list of previous versions of the list item. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.audio: + title: audio + type: object + properties: + album: + type: string + description: The title of the album for this audio file. + nullable: true + albumArtist: + type: string + description: The artist named on the album for the audio file. + nullable: true + artist: + type: string + description: The performing artist for the audio file. + nullable: true + bitrate: + type: number + description: Bitrate expressed in kbps. + format: int64 + nullable: true + composers: + type: string + description: The name of the composer of the audio file. + nullable: true + copyright: + type: string + description: Copyright information for the audio file. + nullable: true + disc: + maximum: 32767 + minimum: -32768 + type: number + description: The number of the disc this audio file came from. + format: int16 + nullable: true + discCount: + maximum: 32767 + minimum: -32768 + type: number + description: The total number of discs in this album. + format: int16 + nullable: true + duration: + type: number + description: 'Duration of the audio file, expressed in milliseconds' + format: int64 + nullable: true + genre: + type: string + description: The genre of this audio file. + nullable: true + hasDrm: + type: boolean + description: Indicates if the file is protected with digital rights management. + nullable: true + isVariableBitrate: + type: boolean + description: Indicates if the file is encoded with a variable bitrate. + nullable: true + title: + type: string + description: The title of the audio file. + nullable: true + track: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of the track on the original disc for this audio file. + format: int32 + nullable: true + trackCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The total number of tracks on the original disc for this audio file. + format: int32 + nullable: true + year: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The year the audio file was recorded. + format: int32 + nullable: true + additionalProperties: + type: object + microsoft.graph.bundle: + title: bundle + type: object + properties: + album: + $ref: '#/components/schemas/microsoft.graph.album' + childCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Number of children contained immediately within this container. + format: int32 + nullable: true + additionalProperties: + type: object + microsoft.graph.file: + title: file + type: object + properties: + archiveStatus: + $ref: '#/components/schemas/microsoft.graph.fileArchiveStatus' + hashes: + $ref: '#/components/schemas/microsoft.graph.hashes' + mimeType: + type: string + description: The MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. Read-only. + nullable: true + processingMetadata: + type: boolean + nullable: true + additionalProperties: + type: object + microsoft.graph.fileSystemInfo: + title: fileSystemInfo + type: object + properties: + 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: The UTC date and time the file was created on a client. + format: date-time + nullable: true + lastAccessedDateTime: + 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 the file was last accessed. Available for the recent file list only. + format: date-time + nullable: true + lastModifiedDateTime: + 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 the file was last modified on a client. + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.folder: + title: folder + type: object + properties: + childCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Number of children contained immediately within this container. + format: int32 + nullable: true + view: + $ref: '#/components/schemas/microsoft.graph.folderView' + additionalProperties: + type: object + microsoft.graph.image: + title: image + type: object + properties: + height: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'Optional. Height of the image, in pixels. Read-only.' + format: int32 + nullable: true + width: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'Optional. Width of the image, in pixels. Read-only.' + format: int32 + nullable: true + additionalProperties: + type: object + microsoft.graph.geoCoordinates: + title: geoCoordinates + type: object + properties: + altitude: + type: number + description: 'Optional. The altitude (height), in feet, above sea level for the item. Read-only.' + format: double + nullable: true + latitude: + type: number + description: 'Optional. The latitude, in decimal, for the item. Writable on OneDrive Personal.' + format: double + nullable: true + longitude: + type: number + description: 'Optional. The longitude, in decimal, for the item. Writable on OneDrive Personal.' + format: double + nullable: true + additionalProperties: + type: object + microsoft.graph.malware: + title: malware + type: object + properties: + description: + type: string + description: Contains the virus details for the malware facet. + nullable: true + additionalProperties: + type: object + microsoft.graph.media: + title: media + type: object + properties: + isTranscriptionShown: + type: boolean + description: 'If a file has a transcript, this setting controls if the closed captions / transcription for the media file should be shown to people during viewing. Read-Write.' + nullable: true + mediaSource: + $ref: '#/components/schemas/microsoft.graph.mediaSource' + additionalProperties: + type: object + microsoft.graph.package: + title: package + type: object + properties: + type: + type: string + description: 'Indicates the type of package. While oneNote is the only currently defined value, you should expect other package types to be returned and handle them accordingly.' + nullable: true + additionalProperties: + type: object + microsoft.graph.pendingOperations: + title: pendingOperations + type: object + properties: + pendingContentUpdate: + $ref: '#/components/schemas/microsoft.graph.pendingContentUpdate' + additionalProperties: + type: object + microsoft.graph.photo: + title: photo + type: object + properties: + cameraMake: + type: string + description: Camera manufacturer. Read-only. + nullable: true + cameraModel: + type: string + description: Camera model. Read-only. + nullable: true + exposureDenominator: + type: number + description: The denominator for the exposure time fraction from the camera. Read-only. + format: double + nullable: true + exposureNumerator: + type: number + description: The numerator for the exposure time fraction from the camera. Read-only. + format: double + nullable: true + fNumber: + type: number + description: The F-stop value from the camera. Read-only. + format: double + nullable: true + focalLength: + type: number + description: The focal length from the camera. Read-only. + format: double + nullable: true + iso: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The ISO value from the camera. Read-only. + format: int32 + nullable: true + orientation: + maximum: 32767 + minimum: -32768 + type: number + description: The orientation value from the camera. Writable on OneDrive Personal. + format: int16 + nullable: true + takenDateTime: + 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 date and time the photo was taken in UTC time. Read-only. + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.publicationFacet: + title: publicationFacet + type: object + properties: + checkedOutBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + level: + type: string + description: The state of publication for this document. Either published or checkout. Read-only. + nullable: true + versionId: + type: string + description: The unique identifier for the version that is visible to the current caller. Read-only. + nullable: true + additionalProperties: + type: object + microsoft.graph.remoteItem: + title: remoteItem + type: object + properties: + createdBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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 item creation. Read-only. + format: date-time + nullable: true + file: + $ref: '#/components/schemas/microsoft.graph.file' + fileSystemInfo: + $ref: '#/components/schemas/microsoft.graph.fileSystemInfo' + folder: + $ref: '#/components/schemas/microsoft.graph.folder' + id: + type: string + description: Unique identifier for the remote item in its drive. Read-only. + nullable: true + image: + $ref: '#/components/schemas/microsoft.graph.image' + lastModifiedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + lastModifiedDateTime: + 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 the item was last modified. Read-only. + format: date-time + nullable: true + name: + type: string + description: Optional. Filename of the remote item. Read-only. + nullable: true + package: + $ref: '#/components/schemas/microsoft.graph.package' + parentReference: + $ref: '#/components/schemas/microsoft.graph.itemReference' + shared: + $ref: '#/components/schemas/microsoft.graph.shared' + sharepointIds: + $ref: '#/components/schemas/microsoft.graph.sharepointIds' + size: + type: number + description: Size of the remote item. Read-only. + format: int64 + nullable: true + specialFolder: + $ref: '#/components/schemas/microsoft.graph.specialFolder' + video: + $ref: '#/components/schemas/microsoft.graph.video' + webDavUrl: + type: string + description: DAV compatible URL for the item. + nullable: true + webUrl: + type: string + description: URL that displays the resource in the browser. Read-only. + nullable: true + additionalProperties: + type: object + microsoft.graph.searchResult: + title: searchResult + type: object + properties: + onClickTelemetryUrl: + type: string + description: A callback URL that can be used to record telemetry information. The application should issue a GET on this URL if the user interacts with this item to improve the quality of results. + nullable: true + additionalProperties: + type: object + microsoft.graph.shared: + title: shared + type: object + properties: + owner: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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 + additionalProperties: + type: object + microsoft.graph.driveItemSource: + title: driveItemSource + type: object + properties: + application: + $ref: '#/components/schemas/microsoft.graph.driveItemSourceApplication' + externalId: + type: string + description: The external identifier for the drive item from the source. + nullable: true + additionalProperties: + type: object + microsoft.graph.specialFolder: + title: specialFolder + type: object + properties: + name: + type: string + description: The unique identifier for this item in the /drive/special collection + nullable: true + additionalProperties: + type: object + microsoft.graph.video: + title: video + type: object + properties: + audioBitsPerSample: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Number of audio bits per sample. + format: int32 + nullable: true + audioChannels: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Number of audio channels. + format: int32 + nullable: true + audioFormat: + type: string + description: 'Name of the audio format (AAC, MP3, etc.).' + nullable: true + audioSamplesPerSecond: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Number of audio samples per second. + format: int32 + nullable: true + bitrate: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Bit rate of the video in bits per second. + format: int32 + nullable: true + duration: + type: number + description: Duration of the file in milliseconds. + format: int64 + nullable: true + fourCC: + type: string + description: '''Four character code'' name of the video format.' + nullable: true + frameRate: + type: number + format: double + nullable: true + height: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'Height of the video, in pixels.' + format: int32 + nullable: true + width: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'Width of the video, in pixels.' + format: int32 + nullable: true + additionalProperties: + type: object + microsoft.graph.driveItemViewpoint: + title: driveItemViewpoint + type: object + properties: + accessOperations: + $ref: '#/components/schemas/microsoft.graph.driveItemAccessOperationsViewpoint' + sharing: + $ref: '#/components/schemas/microsoft.graph.sharingViewpoint' + additionalProperties: + type: object + microsoft.graph.itemRetentionLabel: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: itemRetentionLabel + type: object + properties: + isLabelAppliedExplicitly: + type: boolean + description: 'Specifies whether the label is applied explicitly on the item. True indicates that the label is applied explicitly; otherwise, the label is inherited from its parent. Read-only.' + nullable: true + labelAppliedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + labelAppliedDateTime: + 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 date and time when the label was applied on the item. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.' + format: date-time + nullable: true + name: + type: string + description: The retention label on the document. Read-write. + nullable: true + retentionSettings: + $ref: '#/components/schemas/microsoft.graph.retentionLabelSettings' + additionalProperties: + type: object + microsoft.graph.subscription: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: subscription + type: object + properties: + applicationId: + type: string + description: Optional. Identifier of the application used to create the subscription. Read-only. + nullable: true + changeType: + type: string + description: 'Required. Indicates the type of change in the subscribed resource that raises a change notification. The supported values are: created, updated, deleted. Multiple values can be combined using a comma-separated list. Note: Drive root item and list change notifications support only the updated changeType. User and group change notifications support updated and deleted changeType. Use updated to receive notifications when user or group is created, updated, or soft deleted. Use deleted to receive notifications when user or group is permanently deleted.' + clientState: + type: string + description: Optional. Specifies the value of the clientState property sent by the service in each change notification. The maximum length is 255 characters. The client can check that the change notification came from the service by comparing the value of the clientState property sent with the subscription with the value of the clientState property received with each change notification. + nullable: true + creatorId: + type: string + description: 'Optional. Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the ID of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the ID of the service principal corresponding to the app. Read-only.' + nullable: true + encryptionCertificate: + type: string + description: Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional but required when includeResourceData is true. + nullable: true + encryptionCertificateId: + type: string + description: Optional. A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when includeResourceData is true. + nullable: true + expirationDateTime: + 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: 'Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. Any value under 45 minutes after the time of the request is automatically set to 45 minutes after the request time. For the maximum supported subscription length of time, see Subscription lifetime.' + format: date-time + includeResourceData: + type: boolean + description: 'Optional. When set to true, change notifications include resource data (such as content of a chat message).' + nullable: true + latestSupportedTlsVersion: + type: string + description: 'Optional. Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by notificationUrl, supports. The possible values are: v10, v11, v12, v13. For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set timeline allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. For these subscribers, not setting this property per the timeline would result in subscription operations failing. For subscribers whose notification endpoint already supports TLS 1.2, setting this property is optional. In such cases, Microsoft Graph defaults the property to v1_2.' + nullable: true + lifecycleNotificationUrl: + type: string + description: 'Required for Teams resources if the expirationDateTime value is more than 1 hour from now; optional otherwise. The URL of the endpoint that receives lifecycle notifications, including subscriptionRemoved, reauthorizationRequired, and missed notifications. This URL must make use of the HTTPS protocol. For more information, see Reduce missing subscriptions and change notifications.' + nullable: true + notificationContentType: + type: string + description: Optional. Desired content-type for Microsoft Graph change notifications for supported resource types. The default content-type is application/json. + nullable: true + notificationQueryOptions: + type: string + description: 'Optional. OData query options for specifying the value for the targeting resource. Clients receive notifications when the resource reaches the state matching the query options provided here. With this new property in the subscription creation payload along with all existing properties, Webhooks deliver notifications whenever a resource reaches the desired state mentioned in the notificationQueryOptions property. For example, when the print job is completed or when a print job resource isFetchable property value becomes true etc. Supported only for Universal Print Service. For more information, see Subscribe to change notifications from cloud printing APIs using Microsoft Graph.' + nullable: true + notificationUrl: + type: string + description: Required. The URL of the endpoint that receives the change notifications. This URL must make use of the HTTPS protocol. Any query string parameter included in the notificationUrl property is included in the HTTP POST request when Microsoft Graph sends the change notifications. + notificationUrlAppId: + type: string + description: Optional. The app ID that the subscription service can use to generate the validation token. The value allows the client to validate the authenticity of the notification received. + nullable: true + resource: + type: string + description: Required. Specifies the resource that is monitored for changes. Don't include the base URL (https://graph.microsoft.com/beta/). See the possible resource path values for each supported resource. + additionalProperties: + type: object + microsoft.graph.thumbnailSet: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: thumbnailSet + type: object + properties: + large: + $ref: '#/components/schemas/microsoft.graph.thumbnail' + medium: + $ref: '#/components/schemas/microsoft.graph.thumbnail' + small: + $ref: '#/components/schemas/microsoft.graph.thumbnail' + source: + $ref: '#/components/schemas/microsoft.graph.thumbnail' + additionalProperties: + type: object + description: The ThumbnailSet resource is a keyed collection of thumbnail resources. + microsoft.graph.driveItemVersion: + allOf: + - $ref: '#/components/schemas/microsoft.graph.baseItemVersion' + - title: driveItemVersion + type: object + properties: + content: + type: string + format: base64url + nullable: true + size: + type: number + description: Indicates the size of the content stream for this version of the item. + format: int64 + nullable: true + additionalProperties: + type: object + microsoft.graph.workbook: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: workbook + type: object + properties: + application: + $ref: '#/components/schemas/microsoft.graph.workbookApplication' + comments: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.workbookComment' + description: Represents a collection of comments in a workbook. + x-ms-navigationProperty: true + functions: + $ref: '#/components/schemas/microsoft.graph.workbookFunctions' + names: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.workbookNamedItem' + description: Represents a collection of workbooks scoped named items (named ranges and constants). Read-only. + x-ms-navigationProperty: true + operations: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.workbookOperation' + description: 'The status of Workbook operations. Getting an operation collection is not supported, but you can get the status of a long-running operation if the Location header is returned in the response. Read-only. Nullable.' + x-ms-navigationProperty: true + tables: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.workbookTable' + description: Represents a collection of tables associated with the workbook. Read-only. + x-ms-navigationProperty: true + worksheets: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.workbookWorksheet' + description: Represents a collection of worksheets associated with the workbook. Read-only. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.listInfo: + title: listInfo + type: object + properties: + contentTypesEnabled: + type: boolean + description: 'If true, it indicates that content types are enabled for this list.' + nullable: true + hidden: + type: boolean + description: 'If true, it indicates that the list isn''t normally visible in the SharePoint user experience.' + nullable: true + template: + type: string + description: 'Represents the base list template used in creating the list. Possible values include documentLibrary, genericList, task, survey, announcements, contacts, and more.' + nullable: true + additionalProperties: + type: object + microsoft.graph.onenoteEntityHierarchyModel: + allOf: + - $ref: '#/components/schemas/microsoft.graph.onenoteEntitySchemaObjectModel' + - title: onenoteEntityHierarchyModel + type: object + properties: + createdBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + displayName: + type: string + nullable: true + lastModifiedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + lastModifiedDateTime: + 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 + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.notebookLinks: + title: notebookLinks + type: object + properties: + oneNoteClientUrl: + $ref: '#/components/schemas/microsoft.graph.externalLink' + oneNoteWebUrl: + $ref: '#/components/schemas/microsoft.graph.externalLink' + additionalProperties: + type: object + microsoft.graph.onenoteUserRole: + title: onenoteUserRole + enum: + - None + - Owner + - Contributor + - Reader + type: string + microsoft.graph.operation: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: operation + type: object + properties: + 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: The start time of the operation. + format: date-time + nullable: true + lastActionDateTime: + 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 time of the last action of the operation. + format: date-time + nullable: true + status: + $ref: '#/components/schemas/microsoft.graph.operationStatus' + additionalProperties: + type: object + microsoft.graph.onenoteOperationError: + title: onenoteOperationError + type: object + properties: + code: + type: string + description: The error code. + nullable: true + message: + type: string + description: The error message. + nullable: true + additionalProperties: + type: object + microsoft.graph.onenoteEntitySchemaObjectModel: + allOf: + - $ref: '#/components/schemas/microsoft.graph.onenoteEntityBaseModel' + - title: onenoteEntitySchemaObjectModel + type: object + properties: + 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 + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.pageLinks: + title: pageLinks + type: object + properties: + oneNoteClientUrl: + $ref: '#/components/schemas/microsoft.graph.externalLink' + oneNoteWebUrl: + $ref: '#/components/schemas/microsoft.graph.externalLink' + additionalProperties: + type: object + microsoft.graph.onenoteEntityBaseModel: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: onenoteEntityBaseModel + type: object + properties: + self: + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.sectionLinks: + title: sectionLinks + type: object + properties: + oneNoteClientUrl: + $ref: '#/components/schemas/microsoft.graph.externalLink' + oneNoteWebUrl: + $ref: '#/components/schemas/microsoft.graph.externalLink' + additionalProperties: + type: object + microsoft.graph.plannerDelta: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: plannerDelta + type: object + additionalProperties: + type: object + microsoft.graph.plannerArchivalInfo: + title: plannerArchivalInfo + type: object + properties: + justification: + type: string + description: Read-only. Reason why the entity was archived or unarchived. + nullable: true + statusChangedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + statusChangedDateTime: + 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: Read-only. Date and time at which the entity's archive status changed. + format: date-time + nullable: true + additionalProperties: + type: object + microsoft.graph.plannerPlanContainer: + title: plannerPlanContainer + type: object + properties: + containerId: + type: string + description: The identifier of the resource that contains the plan. Optional. + nullable: true + type: + $ref: '#/components/schemas/microsoft.graph.plannerContainerType' + url: + type: string + description: The full canonical URL of the container. Optional. + nullable: true + additionalProperties: + type: object + microsoft.graph.contentSensitivityLabelAssignment: + title: contentSensitivityLabelAssignment + type: object + properties: + assignmentMethod: + $ref: '#/components/schemas/microsoft.graph.sensitivityLabelAssignmentMethod' + justificationText: + type: string + description: The justification text provided when you change the sensitivity label. Used during label downgrade to document the reason. Optional. + nullable: true + sensitivityLabelId: + type: string + description: The unique identifier of the sensitivity label applied to the content. This ID corresponds to a label defined in the Microsoft Information Protection policy. + nullable: true + tenantId: + type: string + description: The unique identifier of the tenant where the sensitivity label is defined and applied. + nullable: true + additionalProperties: + type: object + microsoft.graph.plannerPlanContextCollection: + title: plannerPlanContextCollection + type: object + additionalProperties: + type: object + microsoft.graph.plannerPlanCreation: + title: plannerPlanCreation + type: object + properties: + creationSourceKind: + $ref: '#/components/schemas/microsoft.graph.plannerCreationSourceKind' + additionalProperties: + type: object + microsoft.graph.plannerSharedWithContainer: + allOf: + - $ref: '#/components/schemas/microsoft.graph.plannerPlanContainer' + - title: plannerSharedWithContainer + type: object + properties: + accessLevel: + $ref: '#/components/schemas/microsoft.graph.plannerPlanAccessLevel' + additionalProperties: + type: object + microsoft.graph.plannerBucket: + allOf: + - $ref: '#/components/schemas/microsoft.graph.plannerDelta' + - title: plannerBucket + type: object + properties: + archivalInfo: + $ref: '#/components/schemas/microsoft.graph.plannerArchivalInfo' + creationSource: + $ref: '#/components/schemas/microsoft.graph.plannerBucketCreation' + isArchived: + type: boolean + description: 'Read-only. If set totrue, the bucket is archived. An archived bucket is read-only.' + nullable: true + name: + type: string + description: Name of the bucket. + orderHint: + type: string + description: 'Hint used to order items of this type in a list view. For details about the supported format, see Using order hints in Planner.' + nullable: true + planId: + type: string + description: Plan ID to which the bucket belongs. + nullable: true + tasks: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.plannerTask' + description: Read-only. Nullable. The collection of tasks in the bucket. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.plannerPlanDetails: + allOf: + - $ref: '#/components/schemas/microsoft.graph.plannerDelta' + - title: plannerPlanDetails + type: object + properties: + categoryDescriptions: + $ref: '#/components/schemas/microsoft.graph.plannerCategoryDescriptions' + contextDetails: + $ref: '#/components/schemas/microsoft.graph.plannerPlanContextDetailsCollection' + sharedWith: + $ref: '#/components/schemas/microsoft.graph.plannerUserIds' + additionalProperties: + type: object + microsoft.graph.plannerTask: + allOf: + - $ref: '#/components/schemas/microsoft.graph.plannerDelta' + - title: plannerTask + type: object + properties: + activeChecklistItemCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'The number of checklist items with value set to false, representing incomplete items.' + format: int32 + nullable: true + appliedCategories: + $ref: '#/components/schemas/microsoft.graph.plannerAppliedCategories' + archivalInfo: + $ref: '#/components/schemas/microsoft.graph.plannerArchivalInfo' + assigneePriority: + type: string + description: 'A hint that is used to order items of this type in a list view. For more information, see Using order hints in planner.' + nullable: true + assignments: + $ref: '#/components/schemas/microsoft.graph.plannerAssignments' + bucketId: + type: string + description: Bucket ID to which the task belongs. The bucket needs to be in the same plan as the task. The value of the bucketId property is 28 characters long and case-sensitive. Format validation is done on the service. + nullable: true + checklistItemCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The number of checklist items that are present on the task. + format: int32 + nullable: true + completedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + completedDateTime: + 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: 'Read-only. The date and time at which the ''percentComplete'' of the task is set to ''100''. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + conversationThreadId: + type: string + description: The thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group. + nullable: true + createdBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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: 'Read-only. The date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + creationSource: + $ref: '#/components/schemas/microsoft.graph.plannerTaskCreation' + dueDateTime: + 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 date and time at which the task is due. The timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + hasChat: + type: boolean + description: 'Read-only. This value is true if the task has chat messages associated with it. Otherwise, false.' + hasDescription: + type: boolean + description: 'Read-only. This value is true if the details object of the task has a nonempty description. Otherwise, false.' + nullable: true + isArchived: + type: boolean + description: 'Read-only. If set to true, the task is archived. An archived task is read-only.' + nullable: true + isOnMyDay: + type: boolean + description: 'Indicates whether to show this task in the MyDay view. If true, it shows the task.' + nullable: true + isOnMyDayLastModifiedDate: + pattern: '^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])$' + type: string + description: Read-only. The date on which task is added to or removed from MyDay. + format: date + nullable: true + lastModifiedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + lastModifiedDateTime: + 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 + format: date-time + nullable: true + orderHint: + type: string + description: 'The hint used to order items of this type in a list view. For more information, see Using order hints in planner.' + nullable: true + percentComplete: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'The percentage of task completion. When set to 100, the task is completed.' + format: int32 + nullable: true + planId: + type: string + description: Plan ID to which the task belongs. + nullable: true + previewType: + $ref: '#/components/schemas/microsoft.graph.plannerPreviewType' + priority: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: 'The priority of the task. Valid values are between 0 and 10, inclusive. Larger values indicate lower priority. For example, 0 has the highest priority and 10 has the lowest priority. Currently, planner interprets values 0 and 1 as ''urgent'', 2 and 3 and 4 as ''important'', 5, 6, and 7 as ''medium'', and 8, 9, and 10 as ''low''. Currently, planner sets the value 1 for ''urgent'', 3 for ''important'', 5 for ''medium'', and 9 for ''low''.' + format: int32 + nullable: true + recurrence: + $ref: '#/components/schemas/microsoft.graph.plannerTaskRecurrence' + referenceCount: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Number of external references that exist on the task. + format: int32 + nullable: true + specifiedCompletionRequirements: + $ref: '#/components/schemas/microsoft.graph.plannerTaskCompletionRequirements' + startDateTime: + 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 at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z' + format: date-time + nullable: true + title: + type: string + description: Title of the task. + assignedToTaskBoardFormat: + $ref: '#/components/schemas/microsoft.graph.plannerAssignedToTaskBoardTaskFormat' + bucketTaskBoardFormat: + $ref: '#/components/schemas/microsoft.graph.plannerBucketTaskBoardTaskFormat' + details: + $ref: '#/components/schemas/microsoft.graph.plannerTaskDetails' + messages: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.plannerTaskChatMessage' + description: Read-only. Nullable. Chat messages associated with the task. + x-ms-navigationProperty: true + progressTaskBoardFormat: + $ref: '#/components/schemas/microsoft.graph.plannerProgressTaskBoardTaskFormat' + additionalProperties: + type: object + microsoft.graph.siteArchivalDetails: + title: siteArchivalDetails + type: object + properties: + archivedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + archivedDateTime: + 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: 'Time when the container was archived. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + archiveStatus: + $ref: '#/components/schemas/microsoft.graph.siteArchiveStatus' + additionalProperties: + type: object + microsoft.graph.itemActivityStat: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: itemActivityStat + type: object + properties: + access: + $ref: '#/components/schemas/microsoft.graph.itemActionStat' + create: + $ref: '#/components/schemas/microsoft.graph.itemActionStat' + delete: + $ref: '#/components/schemas/microsoft.graph.itemActionStat' + edit: + $ref: '#/components/schemas/microsoft.graph.itemActionStat' + endDateTime: + 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: When the interval ends. Read-only. + format: date-time + nullable: true + incompleteData: + $ref: '#/components/schemas/microsoft.graph.incompleteData' + isTrending: + type: boolean + description: Indicates whether the item is 'trending.' Read-only. + nullable: true + move: + $ref: '#/components/schemas/microsoft.graph.itemActionStat' + startDateTime: + 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: When the interval starts. Read-only. + format: date-time + nullable: true + activities: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.itemActivity' + description: Exposes the itemActivities represented in this itemActivityStat resource. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.booleanColumn: + title: booleanColumn + type: object + additionalProperties: + type: object + microsoft.graph.calculatedColumn: + title: calculatedColumn + type: object + properties: + format: + type: string + description: 'For dateTime output types, the format of the value. The possible values are: dateOnly or dateTime.' + nullable: true + formula: + type: string + description: The formula used to compute the value for this column. + nullable: true + outputType: + type: string + description: 'The output type used to format values in this column. The possible values are: boolean, currency, dateTime, number, or text.' + nullable: true + additionalProperties: + type: object + microsoft.graph.choiceColumn: + title: choiceColumn + type: object + properties: + allowTextEntry: + type: boolean + description: 'If true, allows custom values that aren''t in the configured choices.' + nullable: true + choices: + type: array + items: + type: string + nullable: true + description: The list of values available for this column. + displayAs: + type: string + description: 'How the choices are to be presented in the UX. Must be one of checkBoxes, dropDownMenu, or radioButtons' + nullable: true + additionalProperties: + type: object + microsoft.graph.contentApprovalStatusColumn: + title: contentApprovalStatusColumn + type: object + additionalProperties: + type: object + microsoft.graph.currencyColumn: + title: currencyColumn + type: object + properties: + locale: + type: string + description: Specifies the locale from which to infer the currency symbol. + nullable: true + additionalProperties: + type: object + microsoft.graph.dateTimeColumn: + title: dateTimeColumn + type: object + properties: + displayAs: + type: string + description: 'How the value should be presented in the UX. Must be one of default, friendly, or standard. See below for more details. If unspecified, treated as default.' + nullable: true + format: + type: string + description: Indicates whether the value should be presented as a date only or a date and time. It must be either dateOnly or dateTime. + nullable: true + additionalProperties: + type: object + microsoft.graph.defaultColumnValue: + title: defaultColumnValue + type: object + properties: + formula: + type: string + description: The formula used to compute the default value for the column. + nullable: true + value: + type: string + description: The direct value to use as the default value for the column. + nullable: true + additionalProperties: + type: object + microsoft.graph.geolocationColumn: + title: geolocationColumn + type: object + additionalProperties: + type: object + microsoft.graph.hyperlinkOrPictureColumn: + title: hyperlinkOrPictureColumn + type: object + properties: + isPicture: + type: boolean + description: Specifies whether the display format used for URL columns is an image or a hyperlink. + nullable: true + additionalProperties: + type: object + microsoft.graph.lookupColumn: + title: lookupColumn + type: object + properties: + allowMultipleValues: + type: boolean + description: Indicates whether multiple values can be selected from the source. + nullable: true + allowUnlimitedLength: + type: boolean + description: Indicates whether values in the column should be able to exceed the standard limit of 255 characters. + nullable: true + columnName: + type: string + description: The name of the lookup source column. + nullable: true + listId: + type: string + description: The unique identifier of the lookup source list. + nullable: true + primaryLookupColumnId: + type: string + description: 'If specified, this column is a secondary lookup, pulling an additional field from the list item looked up by the primary lookup. Use the list item looked up by the primary as the source for the column named here.' + nullable: true + additionalProperties: + type: object + microsoft.graph.numberColumn: + title: numberColumn + type: object + properties: + decimalPlaces: + type: string + description: How many decimal places to display. See below for information about the possible values. + nullable: true + displayAs: + type: string + description: 'How the value should be presented in the UX. Must be one of number or percentage. If unspecified, treated as number.' + nullable: true + maximum: + type: number + description: The maximum permitted value. + format: double + nullable: true + minimum: + type: number + description: The minimum permitted value. + format: double + nullable: true + additionalProperties: + type: object + microsoft.graph.personOrGroupColumn: + title: personOrGroupColumn + type: object + properties: + allowMultipleSelection: + type: boolean + description: Indicates whether multiple values can be selected from the source. + nullable: true + chooseFromType: + type: string + description: 'Whether to allow selection of people only, or people and groups. Must be one of peopleAndGroups or peopleOnly.' + nullable: true + displayAs: + type: string + description: How to display the information about the person or group chosen. See below. + nullable: true + additionalProperties: + type: object + microsoft.graph.contentTypeInfo: + title: contentTypeInfo + type: object + properties: + id: + type: string + description: The ID of the content type. + nullable: true + name: + type: string + description: The name of the content type. + nullable: true + additionalProperties: + type: object + microsoft.graph.termColumn: + title: termColumn + 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: + $ref: '#/components/schemas/microsoft.graph.termStore.term' + termSet: + $ref: '#/components/schemas/microsoft.graph.termStore.set' + additionalProperties: + type: object + microsoft.graph.textColumn: + title: textColumn + type: object + properties: + allowMultipleLines: + type: boolean + description: Whether to allow multiple lines of text. + nullable: true + appendChangesToExistingText: + type: boolean + description: 'Whether updates to this column should replace existing text, or append to it.' + nullable: true + linesForEditing: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The size of the text box. + format: int32 + nullable: true + maxLength: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: The maximum number of characters for the value. + format: int32 + nullable: true + textType: + type: string + description: The type of text being stored. Must be one of plain or richText. + nullable: true + additionalProperties: + type: object + microsoft.graph.thumbnailColumn: + title: thumbnailColumn + type: object + additionalProperties: + type: object + microsoft.graph.columnTypes: + title: columnTypes + enum: + - note + - text + - choice + - multichoice + - number + - currency + - dateTime + - lookup + - boolean + - user + - url + - calculated + - location + - geolocation + - term + - multiterm + - thumbnail + - approvalStatus + - unknownFutureValue + type: string + microsoft.graph.columnValidation: + title: columnValidation + type: object + properties: + defaultLanguage: + type: string + description: Default BCP 47 language tag for the description. + nullable: true + descriptions: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.displayNameLocalization' + description: Localized messages that explain what is needed for this column's value to be considered valid. User will be prompted with this message if validation fails. + formula: + type: string + description: 'The formula to validate column value. For examples, see Examples of common formulas in lists' + nullable: true + additionalProperties: + type: object + microsoft.graph.contentModelType: + title: contentModelType + enum: + - teachingMethod + - layoutMethod + - freeformSelectionMethod + - prebuiltContractModel + - prebuiltInvoiceModel + - prebuiltReceiptModel + - unknownFutureValue + type: string + microsoft.graph.documentSet: + title: documentSet + type: object + properties: + allowedContentTypes: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.contentTypeInfo' + description: Content types allowed in document set. + defaultContents: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.documentSetContent' + description: Default contents of document set. + propagateWelcomePageChanges: + type: boolean + description: Indicates whether to add the name of the document set to each file name. + nullable: true + shouldPrefixNameToFile: + type: boolean + description: Add the name of the Document Set to each file name. + nullable: true + welcomePageUrl: + type: string + description: Welcome page absolute URL. + nullable: true + sharedColumns: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + x-ms-navigationProperty: true + welcomePageColumns: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.columnDefinition' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.documentSetContent: + title: documentSetContent + type: object + properties: + contentType: + $ref: '#/components/schemas/microsoft.graph.contentTypeInfo' + fileName: + type: string + description: Name of the file in resource folder that should be added as a default content or a template in the document set + nullable: true + folderName: + type: string + description: Folder name in which the file will be placed when a new document set is created in the library. + nullable: true + additionalProperties: + type: object + microsoft.graph.contentTypeOrder: + title: contentTypeOrder + type: object + properties: + default: + type: boolean + description: Indicates whether this is the default content type. + nullable: true + position: + maximum: 2147483647 + minimum: -2147483648 + type: number + description: Specifies the position in which the content type appears in the selection UI. + format: int32 + nullable: true + additionalProperties: + type: object + microsoft.graph.columnLink: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: columnLink + type: object + properties: + name: + type: string + description: The name of the column in this content type. + nullable: true + additionalProperties: + type: object + microsoft.graph.documentProcessingJobType: + title: documentProcessingJobType + enum: + - file + - folder + - unknownFutureValue + type: string + microsoft.graph.documentProcessingJobStatus: + title: documentProcessingJobStatus + enum: + - inProgress + - completed + - failed + - unknownFutureValue + type: string + microsoft.graph.bitlocker: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: bitlocker + type: object + properties: + recoveryKeys: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.bitlockerRecoveryKey' + description: The recovery keys associated with the bitlocker entity. + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.dataLossPreventionPolicy: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: dataLossPreventionPolicy + type: object + properties: + name: + type: string + nullable: true + additionalProperties: + type: object + microsoft.graph.informationProtectionPolicy: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: informationProtectionPolicy + type: object + properties: + labels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.informationProtectionLabel' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.sensitivityLabel: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: sensitivityLabel + type: object + properties: + actionSource: + $ref: '#/components/schemas/microsoft.graph.labelActionSource' + applicableTo: + $ref: '#/components/schemas/microsoft.graph.sensitivityLabelTarget' + applicationMode: + $ref: '#/components/schemas/microsoft.graph.applicationMode' + autoTooltip: + type: string + nullable: true + color: + type: string + nullable: true + description: + type: string + nullable: true + displayName: + type: string + nullable: true + hasProtection: + type: boolean + nullable: true + isDefault: + type: boolean + nullable: true + isEnabled: + type: boolean + nullable: true + isEndpointProtectionEnabled: + type: boolean + nullable: true + isScopedToUser: + type: boolean + nullable: true + locale: + type: string + nullable: true + name: + type: string + nullable: true + priority: + maximum: 2147483647 + minimum: -2147483648 + type: number + format: int32 + nullable: true + toolTip: + type: string + nullable: true + rights: + $ref: '#/components/schemas/microsoft.graph.usageRightsIncluded' + sublabels: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.sensitivityLabel' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.sensitivityPolicySettings: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: sensitivityPolicySettings + type: object + properties: + applicableTo: + $ref: '#/components/schemas/microsoft.graph.sensitivityLabelTarget' + downgradeSensitivityRequiresJustification: + type: boolean + nullable: true + helpWebUrl: + type: string + nullable: true + isMandatory: + type: boolean + nullable: true + additionalProperties: + type: object + microsoft.graph.threatAssessmentRequest: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: threatAssessmentRequest + type: object + properties: + category: + $ref: '#/components/schemas/microsoft.graph.threatCategory' + contentType: + $ref: '#/components/schemas/microsoft.graph.threatAssessmentContentType' + createdBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + 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: 'The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + expectedAssessment: + $ref: '#/components/schemas/microsoft.graph.threatExpectedAssessment' + requestSource: + $ref: '#/components/schemas/microsoft.graph.threatAssessmentRequestSource' + status: + $ref: '#/components/schemas/microsoft.graph.threatAssessmentStatus' + results: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.threatAssessmentResult' + description: 'A collection of threat assessment results. Read-only. By default, a GET /threatAssessmentRequests/{id} does not return this property unless you apply $expand on it.' + x-ms-navigationProperty: true + additionalProperties: + type: object + microsoft.graph.longRunningOperation: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: longRunningOperation + type: object + properties: + 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: 'The start time of the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + lastActionDateTime: + 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 time of the last action in the operation. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.' + format: date-time + nullable: true + resourceLocation: + type: string + description: URI of the resource that the operation is performed on. + nullable: true + status: + $ref: '#/components/schemas/microsoft.graph.longRunningOperationStatus' + statusDetail: + type: string + description: Details about the status of the operation. + nullable: true + additionalProperties: + type: object + description: The status of a long-running operation. + microsoft.graph.publicError: + title: publicError + type: object + properties: + code: + type: string + description: Represents the error code. + nullable: true + details: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.publicErrorDetail' + description: Details of the error. + innerError: + $ref: '#/components/schemas/microsoft.graph.publicInnerError' + message: + type: string + description: A non-localized message for the developer. + nullable: true + target: + type: string + description: The target of the error. + nullable: true + additionalProperties: + type: object + microsoft.graph.pageLayoutType: + title: pageLayoutType + enum: + - microsoftReserved + - article + - home + - unknownFutureValue + - newsLink + - videoNewsLink + type: string + microsoft.graph.titleArea: + title: titleArea + type: object + properties: + alternativeText: + type: string + description: Alternative text on the title area. + nullable: true + enableGradientEffect: + type: boolean + description: Indicates whether the title area has a gradient effect enabled. + nullable: true + imageWebUrl: + type: string + description: URL of the image in the title area. + nullable: true + layout: + $ref: '#/components/schemas/microsoft.graph.titleAreaLayoutType' + serverProcessedContent: + $ref: '#/components/schemas/microsoft.graph.serverProcessedContent' + showAuthor: + type: boolean + description: Indicates whether the author should be shown in title area. + nullable: true + showPublishedDate: + type: boolean + description: Indicates whether the published date should be shown in title area. + nullable: true + showTextBlockAboveTitle: + type: boolean + description: Indicates whether the text block above title should be shown in title area. + nullable: true + textAboveTitle: + type: string + description: The text above title line. + nullable: true + textAlignment: + $ref: '#/components/schemas/microsoft.graph.titleAreaTextAlignmentType' + additionalProperties: + type: object + microsoft.graph.canvasLayout: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: canvasLayout + type: object + properties: + horizontalSections: + type: array + items: + $ref: '#/components/schemas/microsoft.graph.horizontalSection' + description: Collection of horizontal sections on the SharePoint page. + x-ms-navigationProperty: true + verticalSection: + $ref: '#/components/schemas/microsoft.graph.verticalSection' + additionalProperties: + type: object + microsoft.graph.webPart: + allOf: + - $ref: '#/components/schemas/microsoft.graph.entity' + - title: webPart + type: object + additionalProperties: + type: object + microsoft.graph.sharePointIdentitySet: + allOf: + - $ref: '#/components/schemas/microsoft.graph.identitySet' + - title: sharePointIdentitySet + type: object + properties: + group: + $ref: '#/components/schemas/microsoft.graph.identity' + sharePointGroup: + $ref: '#/components/schemas/microsoft.graph.sharePointGroupIdentity' + siteGroup: + $ref: '#/components/schemas/microsoft.graph.sharePointIdentity' + siteUser: + $ref: '#/components/schemas/microsoft.graph.sharePointIdentity' + additionalProperties: + type: object + microsoft.graph.sharingInvitation: + title: sharingInvitation + type: object + properties: + email: + type: string + description: The email address provided for the recipient of the sharing invitation. Read-only. + nullable: true + invitedBy: + $ref: '#/components/schemas/microsoft.graph.identitySet' + redeemedBy: + type: string + nullable: true + signInRequired: + type: boolean + description: If true the recipient of the invitation needs to sign in in order to access the shared item. Read-only. + nullable: true + additionalProperties: + type: object + microsoft.graph.sharingLink: + title: sharingLink + type: object + properties: + application: + $ref: '#/components/schemas/microsoft.graph.identity' + configuratorUrl: + type: string + nullable: true + preventsDownload: + type: boolean + description: 'If true then the user can only use this link to view the item on the web, and cannot use it to download the contents of the item. Only for OneDrive for Business and SharePoint.' + nullable: true + scope: + type: string + description: 'The scope of the link represented by this permission. Value anonymous indicates the link is usable by anyone, organization indicates the link is only usable for users signed into the same tenant.' + nullable: true + type: + type: string + description: The type of the link created. + nullable: true + webHtml: + type: string + description: 'For embed links, this property contains the HTML code for an