Service | Microsoft Docs article | Related commit history on GitHub | Change details |
---|---|---|---|
v1.0 | Accesspackageassignmentrequest Resume | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/accesspackageassignmentrequest-resume.md | Title: "accessPackageAssignmentRequest: resume" -description: "Resume accessPackageAssignmentRequest objects." +description: "Resume a user's access package request after waiting for a callback from a custom extension." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -In [Microsoft Entra entitlement management](../resources/entitlementmanagement-overview.md), when an access package policy has been enabled to call out a custom extension and the request processing is waiting for the callback from the customer, the customer can initiate a resume action. It is performed on an [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object whose **requestStatus** is in a `WaitingForCallback` state. +Resume a user's access package request after waiting for a callback from a custom extension. ++In [Microsoft Entra entitlement management](../resources/entitlementmanagement-overview.md), when an access package policy has been enabled to call out a custom extension and the request processing is waiting for the callback from the customer, the customer can initiate a resume action. It's performed on an [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object whose **requestStatus** is in a `WaitingForCallback` state. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "accesspackageassignmentrequest_resume" } --> [!INCLUDE [permissions-table](../includes/permissions/accesspackageassignmentrequest-resume-permissions.md)] +> [!IMPORTANT] +> App-only access can be authorized *without* granting the `EntitlementManagement.ReadWrite.All` application permission to the caller. Instead, assign the caller an [Entitlement Management role](/entr#example-4-create-a-role-assignment-with-access-package-catalog-scope) or [Delegate access governance to access package managers in entitlement management](/entra/id-governance/entitlement-management-delegate-managers#as-a-catalog-owner-delegate-to-an-access-package-manager). + ## HTTP request > [!NOTE] |
v1.0 | Adminreportsettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminreportsettings-get.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "adminreportsettings_get" } --> [!INCLUDE [permissions-table](../includes/permissions/adminreportsettings-get-permissions.md)] -> **Note:** For delegated permissions to allow apps to get report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more details, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization). +> **Note:** For delegated permissions to allow apps to get report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more information, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization). ## HTTP request Choose the permission or permissions marked as least privileged for this API. Us GET /admin/reportSettings ``` +## Optional query parameters ++This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. + ## Request headers | Name | Description | |
v1.0 | Adminreportsettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminreportsettings-update.md | Choose the permission or permissions marked as least privileged for this API. Us <!-- { "blockType": "permissions", "name": "adminreportsettings_update" } --> [!INCLUDE [permissions-table](../includes/permissions/adminreportsettings-update-permissions.md)] -> **Note:** For delegated permissions to allow apps to update report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more details, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization). +> **Note:** For delegated permissions to allow apps to update report settings on behalf of a user, the tenant administrator must have assigned the user the appropriate Microsoft Entra ID limited administrator role. For more information, see [Authorization for APIs to read Microsoft 365 usage reports](/graph/reportroot-authorization). ## HTTP request <!-- { "blockType": "ignored" } --> PATCH /admin/reportSettings | Property | Type | Description | | -- | -- | - |-| displayConcealedNames | Boolean | If set to `true`, all reports will conceal user information such as usernames, groups, and sites. If `false`, all reports will show identifiable information. This property represents a setting in the Microsoft 365 admin center. Required. | +| displayConcealedNames | Boolean | If set to `true`, all reports conceal user information such as usernames, groups, and sites. If `false`, all reports show identifiable information. This property represents a setting in the Microsoft 365 admin center. Required. | ## Response |
v1.0 | Adminwindowsupdates List Deploymentaudiences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-deploymentaudiences.md | Title: "List deploymentAudiences" description: "Get a list of deploymentAudience objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates List Deployments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-deployments.md | Title: "List deployments" description: "Get a list of deployment objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates List Resourceconnections Operationalinsightsconnection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-resourceconnections-operationalinsightsconnection.md | Title: "List operationalInsightsConnections" description: "Get a list of the operationalInsightsConnection objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates List Resourceconnections | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-resourceconnections.md | Title: "List resourceConnections" description: "Get a list of the resourceConnection objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates List Updatableassets Azureaddevice | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets-azureaddevice.md | Title: "List azureADDevice resources" description: "Get a list of azureADDevice objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates List Updatableassets Updatableassetgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets-updatableassetgroup.md | Title: "List updatableAssetGroup resources" description: "Get a list of updatableAssetGroup objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates List Updatableassets | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatableassets.md | Title: "List updatableAssets" description: "Get a list of updatableAsset objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates List Updatepolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-list-updatepolicies.md | Title: "List updatePolicies" description: "Get a list of updatePolicy objects and their properties." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates Post Deploymentaudiences | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-post-deploymentaudiences.md | Title: "Create deploymentAudience" description: "Create a new deploymentAudience object." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates Post Deployments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-post-deployments.md | Title: "Create deployment" description: "Create a new deployment object." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates Post Resourceconnections Operationalinsightsconnection | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-post-resourceconnections-operationalinsightsconnection.md | Title: "Create operationalInsightsConnection" description: "Create a new operationalInsightsConnection object." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates Post Updatableassets Updatableassetgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-post-updatableassets-updatableassetgroup.md | Title: "Create updatableAssetGroup" description: "Create a new updatableAssetGroup object." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Adminwindowsupdates Post Updatepolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/adminwindowsupdates-post-updatepolicies.md | Title: "Create updatePolicy" description: "Create a new updatePolicy object." ms.localizationpriority: medium-+ doc_type: apiPageType |
v1.0 | Alert Updatealerts | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/alert-updatealerts.md | POST /security/alerts/updateAlerts | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Appcatalogs List Teamsapps | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/appcatalogs-list-teamsapps.md | Title: "List teamsApp" description: "List apps from the Microsoft Teams app catalog."-+ ms.localizationpriority: medium doc_type: apiPageType Content-Type: application/json { "id": "YTUyMjhjMjYtYTlhZS00NzAyLTkwZTAtNzlhNTI0NmQyZjdkIyMxLjAuMCMjUHVibGlzaGVk", "authorization": {+ "clientAppId": "6ed63604-0ba7-4a28-bb3a-dda03ea18d54", "requiredPermissionSet": { "resourceSpecificPermissions": [ { Content-Type: application/json "serializedInternalDefinition": null, "createdBy": null, "authorization": {+ "clientAppId": null, "requiredPermissionSet": { "resourceSpecificPermissions": [] } Content-Type: application/json "serializedInternalDefinition": null, "createdBy": null, "authorization": {+ "clientAppId": null, "requiredPermissionSet": { "resourceSpecificPermissions": [] } |
v1.0 | Application List Owners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-list-owners.md | Title: "List owners" -description: "Retrieve a list of owners (directoryObject objects) for an application." + Title: "List owners of an application" +description: "Retrieve a list of owners for an application." ms.localizationpriority: medium doc_type: apiPageType -# List owners +# List owners of an application Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve a list of owners for an application that are [directoryObject](../resources/directoryobject.md) objects. +Retrieve a list of owners for an application that are [directoryObject](../resources/directoryobject.md) types. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [limited-info](../../includes/limited-info.md)] -- ## HTTP request You can address the application using either its **id** or **appId**. **id** and **appId** are referred to as the **Object ID** and **Application (Client) ID**, respectively, in app registrations in the Microsoft Entra admin center. GET /applications(appId='{appId}')/owners ``` ## Optional query parameters-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. +This method supports the `$count`, `$expand`, `$filter`, `$orderby`, `$search`, `$select`, and `$top` [OData query parameters](/graph/query-parameters) to help customize the response. Some queries are supported only when you use the **ConsistencyLevel** header set to `eventual` and `$count`. For more information, see [Advanced query capabilities on directory objects](/graph/aad-advanced-queries). ## Request headers | Name | Description | Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and collection of [directoryObject](../resources/directoryobject.md) objects in the response body. ## Example-##### Request -The following example shows a request. +### Request +The following example shows a request that uses the **appId** alternate key to query the owners of an application. -# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "application_get_owners" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/applications/{id}/owners +GET https://graph.microsoft.com/beta/applications(appId='bbec3106-565f-4907-941e-96b4dbfef21c')/owners ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) --# [JavaScript](#tab/javascript) --# [PHP](#tab/php) --# [PowerShell](#tab/powershell) --# [Python](#tab/python) ----##### Response -The following example shows the response. Note: The response object shown here might be shortened for readability. +### Response +The following example shows the response. It shows only the **id** property as populated while other properties as `null`. This is because the caller did not have permissions to read users in the tenant. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, HTTP/1.1 200 OK Content-type: application/json {- "value": [ - { - "id": "id-value" - } - ] + "@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET applications(appId=<key>)/owners?$select=deletedDateTime", + "value": [ + { + "@odata.type": "#microsoft.graph.user", + "id": "ce4770b3-70b2-4a38-a242-76631e9f7408", + "businessPhones": [], + "displayName": null, + "givenName": null, + "jobTitle": null, + "mail": null, + "mobilePhone": null, + "officeLocation": null, + "preferredLanguage": null, + "surname": null, + "userPrincipalName": null + }, + { + "@odata.type": "#microsoft.graph.user", + "id": "858a9c90-38b3-4e78-b915-234aece712c4", + }, + { + "@odata.type": "#microsoft.graph.user", + "id": "7585d967-f300-43de-b817-7119a6404c5e", + } + ] } ``` |
v1.0 | Application Post Calls | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-post-calls.md | Namespace: microsoft.graph Create [call](../resources/call.md) enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. You need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed. +This API supports the following PSTN scenarios: +++ Incoming call to bot's PSTN number and then bot invites another PSTN.++ Incoming call to bot's PSTN number and then bot transfer to another PSTN.++ Incoming call to bot's PSTN number and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier and then bot invites another PSTN.++ Incoming call to bot's instance identifier and then bot transfer to another PSTN.++ Incoming call to bot's instance identifier and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier from Scheduled Meeting and then bot invites PSTN.++ Outgoing call from bot (with instance identifier) to a PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another Teams user.++ Bot join the scheduled meeting and then invite PSTN.+ [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions If successful, this method returns a `201 Created` response code and a [call](.. The following example shows a request that makes a peer-to-peer call between the bot and the specified user. In this example, the media is hosted by the service. The values of authorization token, callback URL, application ID, application name, user ID, user name, and tenant ID must be replaced with actual values to make the example work. -# [HTTP](#tab/http) - <!-- { "blockType": "request", "name": "create-call-service-hosted-media-1", Content-Type: application/json ], "callOptions": { "@odata.type": "#microsoft.graph.outgoingCallOptions",- "isContentSharingNotificationEnabled": true + "isContentSharingNotificationEnabled": true, + "isDeltaRosterEnabled": true }, "mediaConfig": { "@odata.type": "#microsoft.graph.serviceHostedMediaConfig" Content-Type: application/json } ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) --# [JavaScript](#tab/javascript) --# [PHP](#tab/php) --# [PowerShell](#tab/powershell) --# [Python](#tab/python) --- #### Response > **Note:** The response object shown here might be shortened for readability. Content-Type: application/json "chatInfo": null, "meetingInfo": null, "transcription": null,+ "callOptions": { + "@odata.type": "#microsoft.graph.outgoingCallOptions", + "isContentSharingNotificationEnabled": true, + "isDeltaRosterEnabled": true + }, "meetingCapability": null, "toneInfo": null } |
v1.0 | Application Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/application-upsert.md | Create a new [application](../resources/application.md) object if it doesn't exi > [!IMPORTANT] > Using PATCH to set [**passwordCredential**](../resources/passwordcredential.md) is not supported. Use the [addPassword](./application-addpassword.md) and [removePassword](./application-removepassword.md) methods to update the password or secret for an application. ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). |
v1.0 | Applicationsignindetailedsummary Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationsignindetailedsummary-get.md | This method supports the [OData query parameters](/graph/query-parameters) to he | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Applicationtemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-get.md | For general information, see [OData query parameters](/graph/query-parameters). | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Applicationtemplate Instantiate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-instantiate.md | To instantiate non-gallery apps, use the `8adf8e6e-67b2-4cf2-a259-e3dc5476c621` | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Applicationtemplate List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/applicationtemplate-list.md | For general information, see [OData query parameters](/graph/query-parameters). | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Appmanagementpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/appmanagementpolicy-get.md | Content-type: application/json ], "maxLifetime": null }- ] + ], + "applicationRestrictions": { + "identifierUris": { + "nonDefaultUriAddition": { + "restrictForAppsCreatedAfterDateTime": "2024-01-01T10:37:00Z", + "excludeAppsReceivingV2Tokens": true, + "excludeSaml": true + } + } + } } } ] |
v1.0 | Appmanagementpolicy List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/appmanagementpolicy-list.md | Content-type: application/json ], "maxLifetime": null }- ] + ], + "applicationRestrictions": { + "identifierUris": { + "nonDefaultUriAddition": { + "restrictForAppsCreatedAfterDateTime": "2024-01-01T10:37:00Z", + "excludeAppsReceivingV2Tokens": true, + "excludeSaml": true + } + } + } } } ] |
v1.0 | Appmanagementpolicy Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/appmanagementpolicy-post.md | POST https://graph.microsoft.com/beta/policies/appManagementPolicies ], "maxLifetime": null }- ] + ], + "applicationRestrictions": { + "identifierUris": { + "nonDefaultUriAddition": { + "restrictForAppsCreatedAfterDateTime": "2024-01-01T10:37:00Z", + "excludeAppsReceivingV2Tokens": true, + "excludeSaml": true + } + } + } } } |
v1.0 | Approvalitem Cancel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-cancel.md | Namespace: microsoft.graph Cancel the [approval item](../resources/approvalitem.md). The owner of the approval can trigger this endpoint. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalitem-cancel-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalitem_cancel" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitem-cancel-permissions.md)] ## HTTP request If successful, this method returns a `202 Accepted` response code with the opera ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "approvalitemthis.cancel" The following example shows a request. POST https://graph.microsoft.com/beta/solutions/approval/approvalItems/ad65e077-4920-4bbd-a57e-b7f152958b83/cancel ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalitem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-get.md | Namespace: microsoft.graph Read the properties and relationships of an [approvalItem](../resources/approvalitem.md) object. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalitem-get-permissions" -} >-+<!-- { "blockType": "permissions", "name": "approvalitem_get" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitem-get-permissions.md)] ## HTTP request GET /solutions/approval/approvalItems/{approvalItemId} ## Optional query parameters -This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. ## Request headers If successful, this method returns a `200 OK` response code and an [approvalItem The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_approvalitem" } --> -```http +```msgraph-interactive GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/d3a7405e-452a-47e0-9c35-9335225ba55d ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) +++ ### Response The following example shows the response. |
v1.0 | Approvalitem List Requests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-list-requests.md | Namespace: microsoft.graph Get a list of [approvalItemRequest](../resources/approvalitemrequest.md) objects. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalitem-list-requests-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalitem_list_requests" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitem-list-requests-permissions.md)] ## HTTP request GET /solutions/approval/approvalItems/{approvalItemId}/requests ## Optional query parameters -This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$filter`, `$orderby`, `$count` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. ## Request headers If successful, this method returns a `200 OK` response code and a collection of ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_approvalitemrequest" The following example shows a request. GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/d3a7405e-452a-47e0-9c35-9335225ba55d/requests ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalitem List Responses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-list-responses.md | Namespace: microsoft.graph Get a list of [approvalItemResponse](../resources/approvalitemresponse.md) objects. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalitem-list-responses-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalitem_list_responses" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitem-list-responses-permissions.md)] ## HTTP request GET /solutions/approval/approvalItems/{approvalItemId}/responses ## Optional query parameters -This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$filter`, `$orderby`, `$count` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. ## Request headers If successful, this method returns a `200 OK` response code and a collection of ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_approvalitemresponse" The following example shows a request. GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/d3a7405e-452a-47e0-9c35-9335225ba55d/responses ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response Content-Type: application/json "id": "f4d6b152-d3c6-4c27-9bc6-1cd5cdcb8473" } },- "createdDateTime":"2022-04-12T20:51:19Z", - "onBehalfOf":[ - { - "user":{ - "id":"39d1a7fb-5f54-4c89-b513-241683718c9b", - "displayName":"Lilli Allik" - } - } - ] + "createdDateTime":"2022-04-12T20:51:19Z" }, { "id": "d3a7405e-452a-47e0-9c35-9335225ba55d", Content-Type: application/json "displayName": "Lilli Allik" } },- "createdDateTime":"2022-04-12T20:51:19Z", - "onBehalfOf":[ - { - "user":{ - "id":"f4d6b152-d3c6-4c27-9bc6-1cd5cdcb8473", - "displayName":"Jana Pihlak" - } - }, - { - "group":{ - "id":"da9fe780-a3de-48cc-a571-82faa05c8463", - "displayName":"Microsoft Executive" - } - } - ] + "createdDateTime":"2022-04-12T20:51:19Z" } ] } |
v1.0 | Approvalitem Post Responses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-post-responses.md | Namespace: microsoft.graph Create a new [approvalItemResponse](../resources/approvalitemresponse.md) object. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalitem-post-responses-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalitem_post_responses" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitem-post-responses-permissions.md)] ## HTTP request If successful, this method returns a `202 Accepted` response code with the opera ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_approvalitemresponse_from_" Content-Type: application/json } ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalitemrequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitemrequest-get.md | Namespace: microsoft.graph Read the properties and relationships of an [approvalItemRequest](../resources/approvalitemrequest.md) object. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalitemrequest-get-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalitemrequest_get" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitemrequest-get-permissions.md)] ## HTTP request GET /solutions/approval/approvalItems/{approvalItemId}/requests/{approvalItemReq ## Optional query parameters -This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. ## Request headers If successful, this method returns a `200 OK` response code and an [approvalItem ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_approvalitemrequest" The following example shows a request. GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/7d096f68-c4fe-4967-99dc-df0248c33a77/requests/817d2849-c546-47f0-9c38-1a1a38ac6648 ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalitemresponse Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitemresponse-get.md | Namespace: microsoft.graph Read the properties and relationships of an [approvalItemResponse](../resources/approvalitemresponse.md) object. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalitemresponse-get-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalitemresponse_get" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitemresponse-get-permissions.md)] ## HTTP request GET /solutions/approval/approvalItems/{approvalItemId}/responses/{approvalItemRe ## Optional query parameters -This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. ## Request headers If successful, this method returns a `200 OK` response code and an [approvalItem ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_approvalitemresponse" The following example shows a request. GET https://graph.microsoft.com/beta/solutions/approval/approvalItems/7d096f68-c4fe-4967-99dc-df0248c33a77/responses/9d4c5640-1da7-4739-924f-d10b70c734c1 ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvaloperation Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvaloperation-get.md | Namespace: microsoft.graph Read the properties and relationships of an [approvalOperation](../resources/approvaloperation.md) object. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvaloperation-get-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvaloperation_get" } --> [!INCLUDE [permissions-table](../includes/permissions/approvaloperation-get-permissions.md)] ## HTTP request GET /solutions/approval/operations/{approvalOperationId} ## Optional query parameters -This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$filter`, `$orderby`, `$count` and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. ## Request headers If successful, this method returns a `200 OK` response code and an [approvalOper ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_approvaloperation" The following example shows a request. GET https://graph.microsoft.com/beta/solutions/approval/operations/1c281a99-f105-4f88-86fa-52d797323908 ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalsolution Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-get.md | Namespace: microsoft.graph Read the properties of an [approvalSolution](../resources/approvalsolution.md) object to determine the [provisioning](../api/approvalsolution-provision.md) state for a tenant. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalsolution-get-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalsolution_get" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalsolution-get-permissions.md)] ## HTTP request GET /solutions/approval ## Optional query parameters -This method doesn't support the OData query parameters to customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response. ## Request headers If successful, this method returns a `200 OK` response code and an [approvalSolu ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_approvalsolution" The following example shows a request. GET https://graph.microsoft.com/beta/solutions/approval ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalsolution List Approvalitems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-list-approvalitems.md | Namespace: microsoft.graph Get a list of the [approvalItem](../resources/approvalitem.md) objects and their properties. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalsolution-list-approvalitems-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalsolution_list_approvalitems" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalsolution-list-approvalitems-permissions.md)] ## HTTP request GET /solutions/approval/approvalItems ## Optional query parameters -This method supports the `$filter`, `$orderby`, `$top`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. +This method supports the `$filter`, `$orderby`, `$top`, `$count`, and `$select` [OData query parameters](/graph/query-parameters) to help customize the response. If the result set spans multiple pages, the response body contains an `@odata.nextLink` that you can use to page through the result set. ## Request headers If successful, this method returns a `200 OK` response code and a collection of ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_approvalitem" The following example shows a request. GET https://graph.microsoft.com/beta/solutions/approval/approvalItems ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalsolution Post Approvalitems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-post-approvalitems.md | Namespace: microsoft.graph Create a new [approvalItem](../resources/approvalitem.md) object. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalsolution-post-approvalitems-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalsolution_post_approvalitems" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalsolution-post-approvalitems-permissions.md)] ## HTTP request If successful, this method returns a `202 Accepted` response code with the opera ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "create_approvalitem_from_" Content-Type: application/json } ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Approvalsolution Provision | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-provision.md | Namespace: microsoft.graph Provision an [approvalSolution](../resources/approvalsolution.md) on behalf of a tenant. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "approvalsolution-provision-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalsolution_provision" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalsolution-provision-permissions.md)] ## HTTP request If successful, this action returns a `204 No Content` response code. ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "approvalsolutionthis.provision" The following example shows a request. POST https://graph.microsoft.com/beta/solutions/approval/provision ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++ ### Response |
v1.0 | Attachment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attachment-delete.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Delete an attachment from a user calendar [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or [post](../resources/post.md). + [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] ## Permissions |
v1.0 | Attachment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/attachment-get.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] - Read the properties, relationships, or raw contents of an attachment that is attached to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or group [post](../resources/post.md). + An attachment can be one of the following types: * A file. Programmatically, this is a [fileAttachment](../resources/fileattachment.md) resource. See [example 1](#example-1-get-the-properties-of-a-file-attachment). |
v1.0 | Authentication Post Fido2methods | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authentication-post-fido2methods.md | Create a new [fido2AuthenticationMethod](../resources/fido2authenticationmethod. Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "authentication-post-fido2methods-permissions" -} >+<!-- { "blockType": "permissions", "name": "authentication_post_fido2methods" } --> [!INCLUDE [permissions-table](../includes/permissions/authentication-post-fido2methods-permissions.md)] ## HTTP request |
v1.0 | Authentication Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authentication-update.md | Choose the permission or permissions marked as least privileged for this API. Us #### Permissions acting on self -<!-- { "blockType": "permissions", "name": "authentication_get_2" } --> +<!-- { "blockType": "permissions", "name": "authentication_update_2" } --> [!INCLUDE [permissions-table](../includes/permissions/authentication-update-2-permissions.md)] #### Permissions acting on others -<!-- { "blockType": "permissions", "name": "authentication_get_3" } --> +<!-- { "blockType": "permissions", "name": "authentication_update_3" } --> [!INCLUDE [permissions-table](../includes/permissions/authentication-update-3-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)] |
v1.0 | Authenticationeventsflow Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authenticationeventsflow-update.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the properties of an [authenticationEventsFlow](../resources/authenticationeventsflow.md) object. Only the [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object type is supported. +Update the properties of an [authenticationEventsFlow](../resources/authenticationeventsflow.md) object by ID. You must specify the **@odata.type** property and the value of the [authenticationEventsFlow](../resources/authenticationeventsflow.md) object type to update. The following derived subtypes are supported: +- [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) [!INCLUDE [national-cloud-support](../../includes/global-china.md)] You must include the **@odata.type** property with a value of the specific user |priority|Int32|The priority to use for each individual event of the events policy. If multiple competing listeners for an event have the same priority, one is chosen and an error is silently logged. | |onInteractiveAuthFlowStart|[onInteractiveAuthFlowStartHandler](../resources/oninteractiveauthflowstarthandler.md)|The configuration for what to invoke for the onInteractiveAuthFlowStart event. | |onAuthenticationMethodLoadStart|[onAuthenticationMethodLoadStartHandler](../resources/onauthenticationmethodloadstarthandler.md)|The configuration for what to invoke for the onAuthenticationMethodLoadStart event. Must have at least one identity provider linked.|-|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|The configuration for what to invoke for the onAttributeCollection event. You can only update this property if it was configured during user flow creation. If it wasn't, call the [Add attributes to a user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) API instead.| +|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|The configuration for what to invoke for the onAttributeCollection event. <br/><br/><li> You can only update this property if it was configured during user flow creation. If it wasn't, call the [Add attributes to a user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) API first. </li><li> You can't add or remove attributes by updating the **attributeCollectionPage** > **views** > **inputs** and **attributes** objects. Use the [Add attribute to user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) or [Remove attribute from user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) APIs instead to update both objects.</li><li> To update the **attributeCollectionPage** > **views** > **inputs** collection, you must include all objects in the collection, not only the changed objects. <li> The order of objects in the **attributeCollectionPage** > **views** > **inputs** collection corresponds to the order in which the attributes are displayed on the app's sign-up UI. | |onUserCreateStart|[onUserCreateStartHandler](../resources/onusercreatestarthandler.md)|The configuration for what to invoke for the onUserCreateStart event.| ## Response If successful, this method returns a `204 No Content` response code. If unsucces ### Example 1: Update the display name and priority of an authenticationEventsFlow #### Request-The following example shows a request that updates the display name of a specific external identities user flow (an authentication event type), as well as the priority for all the listeners associated with the policy. +The following example shows a request that updates the display name of a specific external identities user flow, as well as the priority for all the listeners associated with the policy. # [HTTP](#tab/http) <!-- { The following example shows the response. HTTP/1.1 204 No Content ``` -### Example 2: Update the onAttributeCollection event of a self-service sign up user flow +### Example 2: Update the page layout of a self-service sign up user flow -Add city (built-in attribute) as an attribute to be collected during the attribute collection step of a self-service sign up user flow. You must specify in the **inputs** object all attributes that you want to retain, otherwise they are removed from the user flow. +The following request updates the configuration of some of the attributes. All the attributes are marked as required; the email attribute is marked as hidden; the input type of the custom attribute is also updated to a radio button with two options. #### Request Content-Type: application/json "hidden": false, "editable": true, "writeToDirectory": true,- "required": false, + "required": true, "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$", "options": [] }, Content-Type: application/json "hidden": false, "editable": true, "writeToDirectory": true,- "required": false, + "required": true, "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$", "options": [] }, {- "attribute": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor", - "label": "Favorite color", - "inputType": "text", + "attribute": "extension_331d514c0c18477583ea7dd5a79feda2_RockorCountry", + "label": "Rock music or Country", + "inputType": "radioSingleSelect", "defaultValue": null, "hidden": false, "editable": true, "writeToDirectory": true,- "required": false, + "required": true, "validationRegEx": "^.*",- "options": [] + "options": [ + { + "label": "Rock music", + "value": "Rock" + }, + { + "label": "Country music", + "value": "Country" + } + ] } ] } The following example shows the response. ``` http HTTP/1.1 204 No Content ```--### Example 3: Remove an attribute collected during a self-service sign up user flow --Remove city as an attribute to be collected during the attribute collection step of a self-service sign up user flow. By excluding the city attribute from the request body, the attribute is removed from the user flow. --#### Request --# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "update_authenticationeventsflow_onattributecollection_beta_e3" -} >-``` http -PATCH https://graph.microsoft.com/beta/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow", - "onAttributeCollection": { - "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp", - "attributeCollectionPage": { - "customStringsFileId": null, - "views": [ - { - "title": null, - "description": null, - "inputs": [ - { - "attribute": "email", - "label": "Email Address", - "inputType": "text", - "defaultValue": null, - "hidden": true, - "editable": false, - "writeToDirectory": true, - "required": true, - "validationRegEx": "^[a-zA-Z0-9.!#$%&’'*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:.[a-zA-Z0-9-]+)*$", - "options": [] - }, - { - "attribute": "displayName", - "label": "Display Name", - "inputType": "text", - "defaultValue": null, - "hidden": false, - "editable": true, - "writeToDirectory": true, - "required": false, - "validationRegEx": "^[a-zA-Z_][0-9a-zA-Z_ ]*[0-9a-zA-Z_]+$", - "options": [] - }, - { - "attribute": "extension_6ea3bc85aec24b1c92ff4a117afb6621_Favoritecolor", - "label": "Favorite color", - "inputType": "text", - "defaultValue": null, - "hidden": false, - "editable": true, - "writeToDirectory": true, - "required": false, - "validationRegEx": "^.*", - "options": [] - } - ] - } - ] - } - } -} -``` --# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) --# [JavaScript](#tab/javascript) --# [PHP](#tab/php) --# [PowerShell](#tab/powershell) --# [Python](#tab/python) ----#### Response --The following example shows the response. -<!-- { - "blockType": "response", - "truncated": true -} >-``` http -HTTP/1.1 204 No Content -``` - |
v1.0 | Authenticationmethod Resetpassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/authenticationmethod-resetpassword.md | In the request body, provide a JSON object with the following parameters. ## Response -If successful, this method returns a `202 Accepted` response code and a **Location** header with a URL to check the status of the reset operation. +If the caller provided a password in the request body, this method returns a `202 Accepted` response code and no response body. The response might also include a **Location** header with a URL to check the status of the [reset operation](longrunningoperation-get.md). -If the caller did not submit a password, a Microsoft-generated password is provided in a JSON object in the response body. +If the caller used the system-generated password option, this method returns a `202 Accepted` response code and a [passwordResetResponse](../resources/passwordresetresponse.md) object in the response body which contains a Microsoft-generated password. The response might also include a **Location** header with a URL to check the status of the [reset operation](longrunningoperation-get.md). ### Response headers The following example shows the response. <!-- { "blockType": "response",- "truncated": true, - "@odata.type": "microsoft.graph.entity" + "truncated": true } --> ```http HTTP/1.1 202 Accepted Content-type: application/json Location: https://graph.microsoft.com/beta/users/6ea91a8d-e32e-41a1-b7bd-d2d185eed0e0/authentication/operations/88e7560c-9ebf-435c-8089-c3998ac1ec51?aadgdc=DUB02P&aadgsu=ssprprod-a -{} ``` <!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98 The following example shows the response. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.entity" + "@odata.type": "microsoft.graph.passwordResetResponse" } --> ```http |
v1.0 | Backuprestoreroot Enable | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-enable.md | Namespace: microsoft.graph Enable the [Microsoft 365 Backup Storage](../resources/backuprestoreroot.md) service for a tenant. +Before you call this API, call [List protection policies](../api/backuprestoreroot-list-protectionpolicies.md) to initialize the data store in the tenant. Data store initialization takes about 5 minutes. If you call this API before the data store is initialized, the call results in an error. + [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions |
v1.0 | Backuprestoreroot List Driveprotectionunits | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-driveprotectionunits.md | Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a collection of [driveProtectionUnit](../resources/driveprotectionunit.md) in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Example 1: List all the driveProtectionUnits in a tenant |
v1.0 | Backuprestoreroot List Mailboxprotectionunits | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-mailboxprotectionunits.md | Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a [mailboxProtectionUnit](../resources/mailboxprotectionunit.md) in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Example 1: List all mailboxProtectionUnits in a tenant |
v1.0 | Backuprestoreroot List Restorepoints | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-restorepoints.md | Title: "List restorePoints" -description: "Get a list of the restorePoint objects and their properties." +description: "Get a list of restorePoint objects and their properties." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a list of the [restorePoint](../resources/restorepoint.md) objects and their properties. +Get a list of [restorePoint](../resources/restorepoint.md) objects and their properties. ++> **Note:** This API returns a maximum of five **restorePoint** objects. If you don't include the `orderBy` parameter, the five most recent restore points are returned. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] Choose the permission or permissions marked as least privileged for this API. Us |Delegated (personal Microsoft account)|Not supported.|Not supported.| |Application|BackupRestore-Restore.Read.All|BackupRestore-Restore.ReadWrite.All| - ## HTTP request <!-- { GET /solutions/backupRestore/restorePoints?$expand=protectionUnit($filter=id eq ``` ## Optional query parameters-This method supports the `$expand` and `$filter` [OData puery parameters](/graph/query-parameters), as shown in the following [example](../api/backuprestoreroot-list-restorepoints.md#request). -The two query parameters are required. +This method supports the `$expand`, `$filter` and `orderBy` [OData query parameters](/graph/query-parameters), as shown in the [example](../api/backuprestoreroot-list-restorepoints.md#request) later in this topic. ++The `$expand` and `$filter` query parameters are required. ## Request headers Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a collection of [restorePoint](../resources/restorepoint.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Backuprestoreroot List Siteprotectionunits | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-list-siteprotectionunits.md | Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a [siteProtectionUnit](../resources/siteprotectionunit.md) in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Example 1: List all the siteProtectionUnits in a tenant |
v1.0 | Backuprestoreroot Post Exchangeprotectionpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-exchangeprotectionpolicies.md | In the request body, include a JSON representation of the [exchangeProtectionPol If successful, this method returns a `201 Created` response code and an [exchangeProtectionPolicy](../resources/exchangeprotectionpolicy.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Backuprestoreroot Post Exchangerestoresessions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md | You can specify the following properties when you create an **exchangeRestoreSes If successful, this method returns a `201 Created` response code and an [exchangeRestoreSession](../resources/exchangerestoresession.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Example 1: Create exchangeRestoreSession with mailboxRestoreArtifacts Content-Type: application/json ``` # [C#](#tab/csharp) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [CLI](#tab/cli) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Go](#tab/go) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Java](#tab/java) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [JavaScript](#tab/javascript) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PHP](#tab/php) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [PowerShell](#tab/powershell) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-Type: application/json The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "exchangerestoresession_create_granularmailboxrestoreartifacts" Content-Type: application/json } ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++ #### Response The following example shows the response. |
v1.0 | Backuprestoreroot Post Onedriveforbusinessprotectionpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessprotectionpolicies.md | You can specify the following properties when creating a **oneDriveForBusinessPr If successful, this method returns a `201 Created` response code and a [oneDriveForBusinessProtectionPolicy](../resources/onedriveforbusinessprotectionpolicy.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Backuprestoreroot Post Onedriveforbusinessrestoresessions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-onedriveforbusinessrestoresessions.md | You can specify the following properties when you create a **oneDriveForBusiness If successful, this method returns a `201 Created` response code and a [oneDriveForBusinessRestoreSession](../resources/onedriveforbusinessrestoresession.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Backuprestoreroot Post Sharepointprotectionpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-sharepointprotectionpolicies.md | You can specify the following properties when creating a **sharePointProtectionP If successful, this method returns a `201 Created` response code and a [sharePointProtectionPolicy](../resources/sharepointprotectionpolicy.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Backuprestoreroot Post Sharepointrestoresessions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-sharepointrestoresessions.md | You can specify the following properties when you create a **sharePointRestoreSe If successful, this method returns a `201 Created` response code and a [sharePointRestoreSession](../resources/sharepointrestoresession.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Bookingappointment Cancel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-cancel.md | POST /solutions/bookingBusinesses/{id}/appointments/{id}/cancel | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingappointment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-delete.md | DELETE /solutions/bookingBusinesses/{id}/appointments/{id} | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingappointment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingappointment-get.md | This method supports the [OData query parameters](/graph/query-parameters) to he | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingbusiness Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-delete.md | DELETE /solutions/bookingBusinesses/{id} ## Request headers | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingbusiness Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-get.md | This method supports the [OData Query Parameters](/graph/query-parameters) to he | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingbusiness List Calendarview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-calendarview.md | This method also supports some of the [OData query parameters](/graph/query-para | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingbusiness List Customers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list-customers.md | This method supports the [OData query parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingbusiness List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-list.md | This method also supports the `query` parameter which accepts a string value. Th ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingbusiness Post Bookingbusinesses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-post-bookingbusinesses.md | POST /solutions/bookingbusinesses ## Request headers | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body In the request body, supply a JSON representation of [bookingBusiness](../resources/bookingbusiness.md) object. |
v1.0 | Bookingbusiness Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-publish.md | POST /solutions/bookingbusinesses/{id}/publish ## Request headers | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingbusiness Unpublish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-unpublish.md | POST /solutions/bookingbusinesses/{id}/unpublish ## Request headers | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingbusiness Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingbusiness-update.md | PATCH /solutions/bookingbusinesses/{id} ## Optional request headers | Name | Description| |:--|:--|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body In the request body, supply the values for relevant fields that should be updated. Existing properties that aren't included in the request body maintains their previous values or are recalculated based on changes to other property values. For best performance, you shouldn't include existing values that haven't changed. |
v1.0 | Bookingcurrency Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcurrency-get.md | This method supports the [OData Query Parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingcurrency List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcurrency-list.md | This method supports the [OData Query Parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingcustomer Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-delete.md | DELETE /solutions/bookingbusinesses/{id}/customers/{id} | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingcustomer Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-get.md | This method supports the [OData query parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingcustomer Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingcustomer-update.md | PATCH /solutions/bookingbusinesses/{id}/customers/{id} | Name | Description| |:--|:--|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body [!INCLUDE [table-intro](../../includes/update-property-table-intro.md)] |
v1.0 | Bookingservice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingservice-delete.md | DELETE /solutions/bookingbusinesses/{id}/services/{id} ## Request headers | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingstaffmember Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-delete.md | DELETE /solutions/bookingbusinesses/{id}/staffMembers/{id} ## Request headers | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Bookingstaffmember Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/bookingstaffmember-get.md | This method supports the [OData query parameters](/graph/query-parameters) to he | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Calendar Permanentdelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calendar-permanentdelete.md | + + Title: "calendar: permanentDelete" +description: "Permanently delete a calendar folder and the events that it contains and remove them from the mailbox." ++ms.localizationpriority: high ++++# calendar: permanentDelete ++Namespace: microsoft.graph +++Permanently delete a calendar folder and the events that it contains and remove them from the mailbox. For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help). ++>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox. +++## Permissions ++Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "calendar_permanentdelete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /users/{usersId}/calendar/permanentDelete +POST /groups/{groupsId}/calendar/permanentDelete +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "calendarthis.permanentdelete" +} +--> +``` http +POST https://graph.microsoft.com/beta/users/{usersId}/calendar/permanentDelete +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Call Answer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/call-answer.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Enable a bot to answer an incoming [call](../resources/call.md). The incoming call request can be an invite from a participant in a group call or a peer-to-peer call. If an invite to a group call is received, the notification contains the [chatInfo](../resources/chatinfo.md) and [meetingInfo](../resources/meetinginfo.md) parameters. +Enable a bot to answer an incoming [call](../resources/call.md). The incoming call request can be an invitation from a participant in a group call or a peer-to-peer call. If an invitation to a group call is received, the notification contains the [chatInfo](../resources/chatinfo.md) and [meetingInfo](../resources/meetinginfo.md) parameters. The bot is expected to answer, [reject](./call-reject.md) or [redirect](./call-redirect.md) the call before the call times out. The current timeout value is 15 seconds. The current timeout value is 15 seconds for regular scenarios, and 5 seconds for policy-based recording scenarios. +This API supports the following PSTN scenarios: +++ Incoming call to bot's PSTN number and then bot invites another PSTN.++ Incoming call to bot's PSTN number and then bot transfer to another PSTN.++ Incoming call to bot's PSTN number and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier and then bot invites another PSTN.++ Incoming call to bot's instance identifier and then bot transfer to another PSTN.++ Incoming call to bot's instance identifier and then bot redirects to another PSTN.++ Incoming call to bot's instance identifier from Scheduled Meeting and then bot invites PSTN.++ Outgoing call from bot (with instance identifier) to a PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another PSTN.++ P2P call between bot and another peer (Teams user, PSTN), bot invites another Teams user.++ Bot join the scheduled meeting and then invite PSTN.+ [!INCLUDE [national-cloud-support](../../includes/global-only.md)] ## Permissions The following example shows how to call this API. #### Request The following example shows the request. -# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "call-answer" Content-Length: 211 ], "callOptions": { "@odata.type": "#microsoft.graph.incomingCallOptions",- "isContentSharingNotificationEnabled": true + "isContentSharingNotificationEnabled": true, + "isDeltaRosterEnabled": true }, "participantCapacity": 200 } ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Go](#tab/go) --# [Java](#tab/java) --# [JavaScript](#tab/javascript) --# [PHP](#tab/php) --# [PowerShell](#tab/powershell) --# [Python](#tab/python) --- #### Response The following example shows the response. |
v1.0 | Callrecording Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/callrecording-delta.md | Namespace: microsoft.graph Get a set of [callRecording](../resources/callrecording.md) resources added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user. -Delta query supports both full synchronization that gets all the recordings for online meetings organized by the user, and incremental synchronization that gets recordings added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that recording view periodically. +Delta query supports both full synchronization that gets all the recordings for online meetings organized by the user, and incremental synchronization that gets recordings added since the last synchronization. Typically, you do an initial full synchronization, and then get incremental changes to that recording view periodically. -A GET request with the delta function returns either: +A GET request with the delta function returns one of the following: -- A `@odata.nextLink` (that contains a URL with a **delta** function call and a `skipToken`), or-- A `@odata.deltaLink` (that contains a URL with a **delta** function call and `deltaToken`).+- An **@odata.nextLink** that contains a URL with a **delta** function call and a `skipToken`. +- An **@odata.deltaLink** that contains a URL with a **delta** function call and a `deltaToken`. -State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same recording view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new recordings added after acquiring `@odata.deltaLink`. +State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL returned from the last GET request to the next **delta** function call for that same recording view. An **@odata.deltaLink** returned in a response signifies that the current round of change tracking is complete. You can save and use the **@odata.deltaLink** URL when you start the next round of synchronization to get the new recordings added after you acquire **@odata.deltaLink**. For more information, see the [delta query](/graph/delta-query-overview) documentation. For more information, see the [delta query](/graph/delta-query-overview) documen The following known issues are associated with this API: -- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).+- [Using the `$top` query parameter might not return the **@odata.nextLink**](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931). - [Transcript URLs might not include any content](https://developer.microsoft.com/en-us/graph/known-issues/?search=22932). - [Recordings aren't exported for meetings that don't have transcription turned on](https://developer.microsoft.com/en-us/graph/known-issues/?search=22933). - [Delta queries might return older artifacts when meetings have unrelated changes](https://developer.microsoft.com/en-us/graph/known-issues/?search=22934). Choose the permission or permissions marked as least privileged for this API. Us ``` http GET /users/{usersId}/onlineMeetings/getAllRecordings(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta ```->**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails. +>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId**. ## Query parameters -Tracking changes in call recordings incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltatoken` and `$skiptoken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response. +Tracking changes in call recordings incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltaToken` and `$skipToken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the **@odata.nextLink** or **@odata.deltaLink** URL provided in the response. -In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response, as that URL already includes the encoded parameters. +In subsequent requests, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL from the previous response, as that URL already includes the encoded parameters. | Query parameter | Type |Description| |:|:--|:-|-| `$deltatoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.| -| `$skiptoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating that there are further changes to be tracked. | -| `$top` | integer | Allows the caller to specify the maximum number of objects per page. | +| `$deltaToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.deltaLink** URL of the previous **delta** function call that indicates the completion of that round of change tracking. Save and apply the entire **@odata.deltaLink** URL including this token in the first request of the next round of change tracking for that collection.| +| `$skipToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.nextLink** URL of the previous **delta** function call that indicates that there are further changes to be tracked. | +| `$top` | Integer | Allows the caller to specify the maximum number of objects per page. | ## Request headers In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLin ## Response -If successful, this method returns a `200 OK` response code and a collection of [callRecording](../resources/callrecording.md) objects in the response body. The response also includes an `@odata.nextLink` URL or an `@odata.deltaLink` URL. +If successful, this method returns a `200 OK` response code and a collection of [callRecording](../resources/callrecording.md) objects in the response body. The response also includes an **@odata.nextLink** URL or an **@odata.deltaLink** URL. ## Examples If successful, this method returns a `200 OK` response code and a collection of The following example shows a series of three requests to synchronize the call recordings available for all the online meetings organized by the user. - Step 1: [initial request](#initial-request) and [response](#initial-response).-- Step 2: [second request](#second-request) and [response](#second-response)+- Step 2: [second request](#second-request) and [response](#second-response). - Step 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round). -See also what you'll do in the [next round to get more recordings](#example-2-next-round-to-get-more-recordings). +See also what you do in the [next round to get more recordings](#example-2-next-round-to-get-more-recordings). #### Initial request -In this example, the call recordings are being synchronized for the first time, so the initial sync request doesn't include any state token. This round returns all recordings available at the time. +In this example, the call recordings synchronize for the first time and the initial sync request doesn't include any state token. This round returns all recordings available at the time. <!-- { "blockType": "ignored" } --> ```http GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/ #### Initial response -The response includes two call recordings and a `@odata.nextLink` response header with a `skipToken`. The `@odata.nextLink` URL indicates there are more call recordings to retrieve. +The response includes two call recordings and an **@odata.nextLink** response header with a `skipToken`. The **@odata.nextLink** URL indicates that more call recordings are available to retrieve. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callRecording", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callRecording)" } --> ```http HTTP/1.1 200 OK Content-type: application/json #### Second request -The second request specifies the `@odata.nextLink` URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the `@odata.nextLink` URL encodes and includes them. +The second request specifies the **@odata.nextLink** URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the **@odata.nextLink** URL encodes and includes them. <!-- { "blockType": "ignored" } --> ```http $skiptoken={skipToken1} #### Second response -The second response returns one or more next call recordings and a `@odata.nextLink` property with a `skipToken`, which indicates there are more recordings. +The second response returns one or more next call recordings and an **@odata.nextLink** property with a `skipToken` that indicates that more recordings are available. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callRecording", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callRecording)" } --> ```http HTTP/1.1 200 OK Content-type: application/json #### Third request -The third request continues to use the latest `@odata.nextLink` returned from the last sync request. +The third request continues to use the latest **@odata.nextLink** returned from the last sync request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2} +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2} ``` #### Third and final response for the round -The third response returns the only remaining recordings and a `@odata.deltaLink` property with a `deltaToken`, which indicates that all recordings are returned. Save and use the `@odata.deltaLink` URL to query for any new recording that is added from this point onwards. +The third response returns the only remaining recordings and an **@odata.deltaLink** property with a `deltaToken` that indicates that all recordings are returned. Save and use the **@odata.deltaLink** URL to query for any new recording that is added from this point onwards. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callRecording", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callRecording)" } --> ```http HTTP/1.1 200 OK Content-type: application/json ### Example 2: Next round to get more recordings -Using the `@odata.deltaLink` from the last request in the last round, you can get only those recordings added since the `@odata.deltaLink` was acquired. +Using the **@odata.deltaLink** from the last request in the last round, you can get only those recordings added since the **@odata.deltaLink** was acquired. #### Request The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1} +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllRecordings(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1} ``` #### Response The following example shows the response. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callRecording", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callRecording)" } --> ```http HTTP/1.1 200 OK |
v1.0 | Calltranscript Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calltranscript-delta.md | Namespace: microsoft.graph Get a set of [callTranscript](../resources/calltranscript.md) resources added for [onlineMeeting](../resources/onlinemeeting.md) instances organized by the specified user. -Delta query supports both full synchronization that gets all the transcripts for online meetings organized by the user, and incremental synchronization that gets transcripts added since the last synchronization. Typically, you would do an initial full synchronization, and then get incremental changes to that transcript view periodically. +Delta query supports both full synchronization that gets all the transcripts for online meetings organized by the user, and incremental synchronization that gets transcripts added since the last synchronization. Typically, you do an initial full synchronization, and then get incremental changes to that transcript view periodically. -A GET request with the delta function returns either: +A GET request with the delta function returns one of the following: -- A `@odata.nextLink` (that contains a URL with a **delta** function call and a `skipToken`), or-- A `@odata.deltaLink` (that contains a URL with a **delta** function call and `deltaToken`).+- An **@odata.nextLink** that contains a URL with a **delta** function call and a `skipToken`. +- An **@odata.deltaLink** that contains a URL with a **delta** function call and a `deltaToken`. -State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL returned from the last GET request to the next **delta** function call for that same transcript view. A `@odata.deltaLink` returned in a response signifies that the current round of change tracking is complete. You can save and use the `@odata.deltaLink` URL when you start the next round of synchronization to get the new transcripts added after acquiring `@odata.deltaLink`. +State tokens are opaque to the client. To proceed with a round of change tracking, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL returned from the last GET request to the next **delta** function call for that same transcript view. An **@odata.deltaLink** returned in a response signifies that the current round of change tracking is complete. You can save and use the **@odata.deltaLink** URL when you start the next round of synchronization to get the new transcripts added after you acquire **@odata.deltaLink**. For more information, see the [delta query](/graph/delta-query-overview) documentation. For more information, see the [delta query](/graph/delta-query-overview) documen The following known issues are associated with this API: -- [Using the `$top` query parameter might not return the @odata.nextLink](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931).+- [Using the `$top` query parameter might not return the **@odata.nextLink**](https://developer.microsoft.com/en-us/graph/known-issues/?search=22931). - [Delta queries might return older artifacts when meetings have unrelated changes](https://developer.microsoft.com/en-us/graph/known-issues/?search=22934). ## Permissions Choose the permission or permissions marked as least privileged for this API. Us ``` http GET /users/{usersId}/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='{userId}',startDateTime={startDateTime})/delta ```->**Note:** If you don't pass the function parameter **meetingOrganizerUserId**, the request fails. +>**Note:** The request fails if you don't pass the function parameter **meetingOrganizerUserId**. ## Query parameters -Tracking changes in call transcripts incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltatoken` and `$skiptoken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the `@odata.nextLink` or `@odata.deltaLink` URL provided in the response. +Tracking changes in call transcripts incurs a round of one or more **delta** function calls. If you use any query parameter (other than `$deltaToken` and `$skipToken`), you must specify it in the initial **delta** request. Microsoft Graph automatically encodes any specified parameters into the token portion of the **@odata.nextLink** or **@odata.deltaLink** URL provided in the response. -In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response, as that URL already includes the encoded parameters. +In subsequent requests, copy and apply the **@odata.nextLink** or **@odata.deltaLink** URL from the previous response, as that URL already includes the encoded parameters. | Query parameter | Type |Description| |:|:--|:-|-| `$deltatoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.deltaLink` URL of the previous **delta** function call, indicating the completion of that round of change tracking. Save and apply the entire `@odata.deltaLink` URL including this token in the first request of the next round of change tracking for that collection.| -| `$skiptoken` | string | A [state token](/graph/delta-query-overview) returned in the `@odata.nextLink` URL of the previous **delta** function call, indicating that there are further changes to be tracked. | -| `$top` | integer | Allows the caller to specify the maximum number of objects per page. | +| `$deltaToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.deltaLink** URL of the previous **delta** function call that indicates the completion of that round of change tracking. Save and apply the entire **@odata.deltaLink** URL including this token in the first request of the next round of change tracking for that collection.| +| `$skipToken` | String | A [state token](/graph/delta-query-overview) returned in the **@odata.nextLink** URL of the previous **delta** function call that indicates that there are further changes to be tracked. | +| `$top` | Integer | Allows the caller to specify the maximum number of objects per page. | ## Request headers In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLin ## Response -If successful, this method returns a `200 OK` response code and a collection of [callTranscript](../resources/calltranscript.md) objects in the response body. The response also includes an `@odata.nextLink` URL or an `@odata.deltaLink` URL. +If successful, this method returns a `200 OK` response code and a collection of [callTranscript](../resources/calltranscript.md) objects in the response body. The response also includes an **@odata.nextLink** URL or an **@odata.deltaLink** URL. ## Examples If successful, this method returns a `200 OK` response code and a collection of The following example shows a series of three requests to synchronize the call transcripts available for all the online meetings organized by the user. - Step 1: [initial request](#initial-request) and [response](#initial-response).-- Step 2: [second request](#second-request) and [response](#second-response)+- Step 2: [second request](#second-request) and [response](#second-response). - Step 3: [third request](#third-request) and [final response](#third-and-final-response-for-the-round). -See also what you'll do in the [next round to get more transcripts](#example-2-next-round-to-get-more-transcripts). +See also what you do in the [next round to get more transcripts](#example-2-next-round-to-get-more-transcripts). #### Initial request -In this example, the call transcripts are being synchronized for the first time, so the initial sync request doesn't include any state token. This round returns all transcripts available at the time. +In this example, the call transcripts synchronize for the first time and the initial sync request doesn't include any state token. This round returns all transcripts available at the time. <!-- { "blockType": "ignored" } --> ```http GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/ #### Initial response -The response includes two call transcripts and a `@odata.nextLink` response header with a `skipToken`. The `@odata.nextLink` URL indicates there are more call transcripts to retrieve. +The response includes two call transcripts and an **@odata.nextLink** response header with a `skipToken`. The **@odata.nextLink** URL indicates that more call transcripts are available to retrieve. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callTranscript", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callTranscript)" } --> ```http HTTP/1.1 200 OK Content-type: application/json #### Second request -The second request specifies the `@odata.nextLink` URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the `@odata.nextLink` URL encodes and includes them. +The second request specifies the **@odata.nextLink** URL returned from the previous response. Notice that it no longer has to specify the same query parameters as in the initial request, as the `skipToken` in the **@odata.nextLink** URL encodes and includes them. <!-- { "blockType": "ignored" } --> ```http $skiptoken={skipToken1} #### Second response -The second response returns one or more next call transcripts and a `@odata.nextLink` property with a `skipToken`, which indicates there are more transcripts. +The second response returns one or more next call transcripts and an **@odata.nextLink** property with a `skipToken` that indicates that more transcripts are available. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callTranscript", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callTranscript)" } --> ```http HTTP/1.1 200 OK Content-type: application/json #### Third request -The third request continues to use the latest `@odata.nextLink` returned from the last sync request. +The third request continues to use the latest **@odata.nextLink** returned from the last sync request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2} +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={skipToken2} ``` #### Third and final response for the round -The third response returns the only remaining transcripts and a `@odata.deltaLink` property with a `deltaToken`, which indicates that all transcripts are returned. Save and use the `@odata.deltaLink` URL to query for any new transcript that is added from this point onwards. +The third response returns the only remaining transcripts and an **@odata.deltaLink** property with a `deltaToken` that indicates that all transcripts are returned. Save and use the **@odata.deltaLink** URL to query for any new transcript that is added from this point onwards. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callTranscript", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callTranscript)" } --> ```http HTTP/1.1 200 OK Content-type: application/json ### Example 2: Next round to get more transcripts -Using the `@odata.deltaLink` from the last request in the last round, you can get only those transcripts added since the `@odata.deltaLink` was acquired. +Using the **@odata.deltaLink** from the last request in the last round, you can get only those transcripts added since the **@odata.deltaLink** was acquired. #### Request The following example shows a request. <!-- { "blockType": "ignored" } --> ```http-GET https://graph.microsoft.com/beta/users({userId})/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1} +GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='8b081ef6-4792-4def-b2c9-c363a1bf41d5')/delta?skipToken={deltaToken1} ``` #### Response The following example shows the response. <!-- { "blockType": "response", "truncated": true,- "@odata.type": "microsoft.graph.callTranscript", - "isCollection": true + "@odata.type": "Collection(microsoft.graph.callTranscript)" } --> ```http HTTP/1.1 200 OK |
v1.0 | Calltranscript Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/calltranscript-get.md | The following example shows how to get a single transcript of an online meeting The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_callTranscript_using_contentCorrelationId", The following example shows a request. GET https://graph.microsoft.com/betFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy/transcripts?$filter=contentcorrelationId+eq+'e87c8cf8-50f7-4252-8b9c-ad08ac0fa88d-0' ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++ #### Response The following example shows the response. |
v1.0 | Channel Delete Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-delete-tabs.md | Title: "Delete tab from channel" description: "Removes (unpins) a tab from the specified channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType Removes (unpins) a tab from the specified [channel](../resources/channel.md) wit ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_delete_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-delete-tabs-permissions.md)] |
v1.0 | Channel Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-delete.md | Title: "Delete channel" description: "Delete the channel."-+ ms.localizationpriority: medium doc_type: apiPageType Delete the [channel](../resources/channel.md). ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-delete-permissions.md)] |
v1.0 | Channel Get Filesfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get-filesfolder.md | Title: "Get filesFolder" description: "Retrieve the filesFolder navigation path of a channel."-+ ms.localizationpriority: high doc_type: apiPageType |
v1.0 | Channel Get Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get-tabs.md | Title: "Get tab in channel" description: "Retrieve the properties and relationships of the specified tab in a channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType Retrieve the properties and relationships of the specified [tab](../resources/te ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_get_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-get-tabs-permissions.md)] |
v1.0 | Channel Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-get.md | Title: "Get channel" description: "Retrieve the properties and relationships of a channel."-+ doc_type: apiPageType ms.localizationpriority: medium |
v1.0 | Channel List Messages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-list-messages.md | Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [permissions-table](../includes/permissions/channel-list-messages-permissions.md)] > [!NOTE]-> - The ChannelMessage.Read.Group permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). -> - The Group.Read.All and Group.ReadWrite.All permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. +> - The `ChannelMessage.Read.Group` permission uses [resource-specific consent](/microsoftteams/platform/graph-api/rsc/resource-specific-consent). +> - The `Group.Read.All` and `Group.ReadWrite.All` permissions are supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission listed in the previous table and avoid using these permissions going forward. ## HTTP request Don't supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and a collection of [chatMessage](../resources/chatmessage.md) objects in the response body. +If successful, this method returns a `200 OK` response code and a collection of [chatMessage](../resources/chatmessage.md) objects in the response body. The channel messages in the response are sorted by the last modified date of the entire reply chain, including both the root channel message and its replies. ## Examples GET https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/ #### Response The following response shows one channel message on the page, and includes a URL in `@odata.nextLink` for a subsequent operation to get the next message in that channel. -The response includes replies of that channel message. In practice, this operation can return up to 1,000 replies of a channel message, and includes a URL in `replies@odata.nextLink` to get any further replies beyond the page size of 1000. This example assumes more than 1,000 replies in that channel message, but for readability, the following response shows only three replies. +The response includes replies of that channel message. In practice, this operation can return up to 1,000 replies of a channel message, and includes a URL in `replies@odata.nextLink` to get any further replies beyond the page size of 1,000. This example assumes more than 1,000 replies in that channel message, but for readability, the following response shows only three replies. <!-- { "blockType": "response", |
v1.0 | Channel List Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-list-tabs.md | Title: "List tabs in channel" description: "Retrieve the list of tabs in the specified channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType Retrieve the list of [tabs](../resources/teamstab.md) in the specified [channel] ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_list_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-list-tabs-permissions.md)] |
v1.0 | Channel Patch Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-patch-tabs.md | Title: "Update tab" description: "Update the properties of the specified tab."-+ ms.localizationpriority: medium doc_type: apiPageType This API can be used to configure the content of the tab. ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_patch_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-patch-tabs-permissions.md)] |
v1.0 | Channel Patch | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-patch.md | Update the properties of the specified [channel](../resources/channel.md). Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_patch" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-patch-permissions.md)] |
v1.0 | Channel Post Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-post-tabs.md | Title: "Add tab to channel" description: "Add (pin) a tab to the specified channel within a team. "-+ ms.localizationpriority: medium doc_type: apiPageType Add (pin) a [tab](../resources/teamstab.md) to the specified [channel](../resour Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_post_tabs" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-post-tabs-permissions.md)] |
v1.0 | Channel Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/channel-post.md | You can add a maximum of 200 members when you create a private channel. Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -This API supports admin permissions. Global admins and Microsoft Teams service admins can access teams that they aren't a member of. +This API supports admin permissions. Microsoft Teams service admins can access teams that they aren't a member of. <!-- { "blockType": "permissions", "name": "channel_post" } --> [!INCLUDE [permissions-table](../includes/permissions/channel-post-permissions.md)] |
v1.0 | Chat Post Tabs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chat-post-tabs.md | Title: "Add tab to chat" description: "Adds (pins) a tab to the specified chat. "-+ ms.localizationpriority: medium doc_type: apiPageType |
v1.0 | Chatmessage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-get.md | Content-type: application/json "reactions": [ { "reactionType": "💯",+ "displayName": "Hundred points", "reactionContentUrl": null, "createdDateTime": "2024-02-14T22:07:36.3Z", "user": { Content-type: application/json }, { "reactionType": "custom",+ "displayName": "microsoft_teams", "reactionContentUrl": "https://graph.microsoft.com/beta/chats/19:bcf84b15c2994a909770f7d05bc4fe16@thread.v2/messages/1706763669648/hostedContents/aWQ9MC13dXMtZDExLTc3ZmI2NmY4MTMwMGI2OGEzYzRkOWUyNmU1YTc5ZmMyLHR5cGU9MSx1cmw9/$value", "createdDateTime": "2024-02-14T22:07:02.288Z", "user": { Content-type: application/json } ``` +### Example 5: Get a chat message with an @mention for everyone ++The following example shows a request to get a chat message that @mentions everyone in a group chat. ++#### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_chatmessage_5", + "sampleKeys": ["19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2", "1725986575123"] +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/chats/19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2/messages/1725986575123 +``` ++#### Response ++The following example shows the response. The message body contains an @mention for everyone in a group chat that is represented by the `<at></at>` tag. The **conversationIdentityType** property is set to `chat` in the **conversation** identity of the **mentioned** object. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.chatMessage" +} --> ++```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats('19%3A80a7ff67c0ef43c19d88a7638be436b1%40thread.v2')/messages/$entity", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET chats('<key>')/messages('<key>')?$select=attachments,body", + "id": "1725986575123", + "replyToId": null, + "etag": "1725986575123", + "messageType": "message", + "createdDateTime": "2024-09-10T16:42:55.123Z", + "lastModifiedDateTime": "2024-09-10T16:42:55.123Z", + "lastEditedDateTime": null, + "deletedDateTime": null, + "subject": null, + "summary": null, + "chatId": "19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2", + "importance": "normal", + "locale": "en-us", + "webUrl": null, + "channelIdentity": null, + "onBehalfOf": null, + "policyViolation": null, + "eventDetail": null, + "from": { + "application": null, + "device": null, + "user": { + "@odata.type": "#microsoft.graph.teamworkUserIdentity", + "id": "28c10244-4bad-4fda-993c-f332faef94f0", + "displayName": "Adele Vance", + "userIdentityType": "aadUser", + "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34" + } + }, + "body": { + "contentType": "html", + "content": "<p>Hi <at id=\"0\">Everyone</at></p>" + }, + "attachments": [], + "mentions": [ + { + "id": 0, + "mentionText": "Everyone", + "mentioned": { + "application": null, + "device": null, + "user": null, + "tag": null, + "conversation": { + "id": "19:80a7ff67c0ef43c19d88a7638be436b1@thread.v2", + "displayName": "Everyone", + "conversationIdentityType": "chat" + } + } + } + ], + "reactions": [] +} +``` + ## Related content - [List messages in a channel](channel-list-messages.md) |
v1.0 | Chatmessage List Hostedcontents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessage-list-hostedcontents.md | This operation doesn't support the [OData query parameters](/graph/query-paramet | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Chatmessagehostedcontent Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/chatmessagehostedcontent-get.md | This operation doesn't support the [OData query parameters](/graph/query-paramet | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Cloudpc Getfrontlinecloudpcaccessstate | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-getfrontlinecloudpcaccessstate.md | Content-Type: application/json { "@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",- "value": "noLicensesAvailable" + "value": "active" } ``` Content-Type: application/json { "@odata.context":"https://graph.microsoft.com/beta/$metadata#Edm.String",- "value": "noLicensesAvailable" + "value": "active" } ``` |
v1.0 | Cloudpc Retrievecloudpcremoteactionresults | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpc-retrievecloudpcremoteactionresults.md | GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/cloudPCs/4 [!INCLUDE [sample-code](../includes/snippets/php/cloudpc-retrievecloudpcremoteactionresults-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/cloudpc-retrievecloudpcremoteactionresults-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Cloudpcreports Getconnectionqualityreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-getconnectionqualityreports.md | Title: "cloudPcReports: getConnectionQualityReports" + Title: "cloudPcReports: getConnectionQualityReports (deprecated)" description: "Get the overall connection quality reports for all devices within a current tenant during a given time period, including metrics like the average round trip time (P50), average available bandwidth, and UDP connection percentage." ms.localizationpriority: medium-# cloudPcReports: getConnectionQualityReports +# cloudPcReports: getConnectionQualityReports (deprecated) Namespace: microsoft.graph Namespace: microsoft.graph Get the overall connection quality reports for all devices within a current tenant during a given time period, including metrics like the average round trip time (P50), average available bandwidth, and UDP connection percentage. Get also other real-time metrics such as last connection round trip time, last connection client IP, last connection gateway, and last connection protocol. +>[!CAUTION] +> This API is deprecated and will stop returning data on December 31, 2024. Going forward, use the [retrieveConnectionQualityReports](cloudpcreports-retrieveconnectionqualityreports.md) API. + [!INCLUDE [national-cloud-support](../../includes/global-us.md)] ## Permissions |
v1.0 | Cloudpcreports Post Exportjobs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-post-exportjobs.md | You can specify the following properties when you create a **cloudPcExportJob**. |Property|Type|Description| |:|:|:| |filter|String|The filter applied on the report. Optional.|-|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`.| +|reportName|cloudPcReportName|The report name. The possible values are: `remoteConnectionHistoricalReports`, `dailyAggregatedRemoteConnectionReports`, `totalAggregatedRemoteConnectionReports`, `sharedUseLicenseUsageReport`, `sharedUseLicenseUsageRealTimeReport`, `unknownFutureValue`, `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`, `regionalConnectionQualityTrendReport`, `regionalConnectionQualityInsightsReport`, `remoteConnectionQualityReport`. You must use the `Prefer: include-unknown-enum-members` request header to get the following values in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `noLicenseAvailableConnectivityFailureReport`, `frontlineLicenseUsageReport`, `frontlineLicenseUsageRealTimeReport`, `remoteConnectionQualityReports`, `inaccessibleCloudPcReports`, `crossRegionDisasterRecoveryReport`.| |select|String collection|The selected columns of the report. Optional.| ## Response |
v1.0 | Cloudpcreports Retrieveconnectionqualityreports | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcreports-retrieveconnectionqualityreports.md | + + Title: "cloudPcReports: retrieveConnectionQualityReports" +description: "Get the overall connection quality reports for all devices in the current tenant, the regional connection quality trend report, and the regional connection quality insight report, including round trip time, available bandwidth, UPD usage, and drop connections." ++ms.localizationpriority: medium ++++# cloudPcReports: retrieveConnectionQualityReports ++Namespace: microsoft.graph +++Get the overall connection quality reports for all devices in the current tenant. This includes the regional connection quality trend report, and the regional connection quality insight report, including round trip time, available bandwidth, UPD usage, and drop connections. +++## Permissions ++Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "cloudpcreports_retrieveconnectionqualityreports" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/virtualEndpoint/reports/retrieveConnectionQualityReports +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Content-Type|application/json. Required.| ++## Request body ++In the request body, supply a JSON representation of the parameters. ++The following table shows the parameters that can be used with this action. ++|Parameter|Type|Description| +|:|:|:| +|filter|String|OData `$filter` syntax. Supported filters include: `and`, `or`, `lt`, `le`, `gt`, `ge`, and `eq`.| +|groupBy|String collection|Specifies how to group the reports. If used, must have the same contents as the **select** parameter.| +|orderBy|String collection|Specifies how to sort the reports.| +|search|String|Specifies a String to search.| +|select|String collection|OData `$select` syntax. The selected columns of the reports. | +|skip|Int32|The number of records to skip.| +|top|Int32|The number of top records to return.| ++## Response ++If successful, this action returns a `200 OK` response code and a Stream in the response body. ++## Examples ++### Request ++The following example shows a request. ++``` http +POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/reports/retrieveConnectionQualityReports +Content-Type: application/json +Content-length: 200 ++{ + "reportName":"regionalConnectionQualityTrendReport", + "filter": "", + "select": ["GatewayRegion", "RoundTripTimeTrend", "AvailableBandwidthTrend", "UDPUtilizationTrend", "DroppedConnectionTrend", "WeeklyAvgRoundTripTimeInMs", "DailyAvgRoundTripTimeInMs", "WeeklyAvailableBandwidthInMBps", "DailyAvailableBandwidthInMBps", "WeeklyUdpUtilization", "DailyWeeklyUdpUtilization", "WeeklyDroppedConnectionsCount", "DailyDroppedConnectionsCount"], + "search": "", + "skip": 0, + "top": 50 +} +``` ++### Response ++The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Edm.Stream" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/octet-stream ++{ + "TotalRowCount": 2, + "Schema": [ + { + "Column": "GatewayRegion", + "PropertyType": "String" + }, + { + "Column": "RoundTripTimeTrend", + "PropertyType": "String" + }, + { + "Column": "AvailableBandwidthTrend", + "PropertyType": "String" + }, + { + "Column": "UDPUtilizationTrend", + "PropertyType": "String" + }, + { + "Column": "DroppedConnectionTrend", + "PropertyType": "String" + }, + { + "Column": "WeeklyAvgRoundTripTimeInMs", + "PropertyType": "Double" + }, + { + "Column": "DailyAvgRoundTripTimeInMs", + "PropertyType": "Double" + }, + { + "Column": "WeeklyAvailableBandwidthInMBps", + "PropertyType": "Double" + }, + { + "Column": "DailyAvailableBandwidthInMBps", + "PropertyType": "Double" + }, + { + "Column": "WeeklyUdpUtilization", + "PropertyType": "Double" + }, + { + "Column": "DailyWeeklyUdpUtilization", + "PropertyType": "Double" + }, + { + "Column": "WeeklyDroppedConnectionsCount", + "PropertyType": "Int32" + }, + { + "Column": "DailyDroppedConnectionsCount", + "PropertyType": "Int32" + } + ], + "Values" :[ + ["Japan East", "Increasing", "Decreasing", "Static", "Decreasing", "296.25", "350.50", "3.1", "2,1", "51.2", "47.8", "19", "29"], + ["Southeast Asia", "Decreasing", "Static", "Increasing", "Increasing", "337.14", "299.50", "1.7", "2,2", "33.5", "67.8", "17", "16"], + ] +} +``` |
v1.0 | Cloudpcshareduseserviceplan Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/cloudpcshareduseserviceplan-get.md | - Title: "Get cloudPcSharedUseServicePlan (deprecated)" -description: "Read the properties and relationships of a cloudPcSharedUseServicePlan object." ---doc_type: apiPageType ---# Get cloudPcSharedUseServicePlan (deprecated) --Namespace: microsoft.graph ---> [!CAUTION] -> The **cloudPcSharedUseServicePlan** resource is deprecated and stopped returning data on April 24, 2024. Going forward, use the [cloudPcFrontLineServicePlan](../resources/cloudpcfrontlineserviceplan.md). --Read the properties and relationships of a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object. ---## Permissions --Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). --<!-- { "blockType": "permissions", "name": "cloudpcshareduseserviceplan_get" } --> --## HTTP request --<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/virtualEndpoint/sharedUseServicePlans/{cloudPcSharedUseServicePlanId} -``` --## Optional query parameters --This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). --## Request headers --|Name|Description| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| --## Request body --Don't supply a request body for this method. --## Response --If successful, this method returns a `200 OK` response code and a [cloudPcSharedUseServicePlan](../resources/cloudpcshareduseserviceplan.md) object in the response body. --## Examples --### Request --The following example shows a request. --<!-- { - "blockType": "request", - "name": "get_cloudpcshareduseserviceplan" -} >-``` http -GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/sharedUseServicePlans/613a8d85-6c33-1268-9f55-b96a6540017c -``` --### Response --The following example shows the response. -->**Note:** The response object shown here might be shortened for readability. -<!-- { - "blockType": "response", - "truncated": true, - "@odata.type": "microsoft.graph.cloudPcSharedUseServicePlan" -} >-``` http -HTTP/1.1 200 OK -Content-Type: application/json --{ - "value": { - "@odata.type": "#microsoft.graph.cloudPcSharedUseServicePlan", - "id": "613a8d85-6c33-1268-9f55-b96a6540017c", - "displayName": "Display Name Value", - "usedCount": "10", - "totalCount": "20" - } -} -``` |
v1.0 | Community Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/community-delete.md | Title: "Delete community" -description: "Delete a community in Viva Engage." +description: "Delete a Viva Engage community along with all associated Microsoft 365 content, including the connected Microsoft 365 group, OneNote notebook, and Planner plans." ms.localizationpriority: medium |
v1.0 | Contact Permanentdelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contact-permanentdelete.md | + + Title: "contact: permanentDelete" +description: "Permanently delete a contact and place it in the Purges folder in the user's mailbox." ++ms.localizationpriority: high ++++# contact: permanentDelete ++Namespace: microsoft.graph +++Permanently delete a contact and place it in the Purges folder in the dumpster in the user's mailbox. Email clients such as Outlook or Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time. ++For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help). +++## Permissions ++Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "contact_permanentdelete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /users/{usersId}/contacts/{contactId}/permanentDelete +POST /users/{usersId}/contactFolders/{contactFolderId}/contacts/{contactId}/permanentDelete +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "contactthis.permanentdelete" +} +--> +``` http +POST https://graph.microsoft.com/beta/users/{usersId}/contacts/{contactId}/permanentDelete +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Contactfolder Permanentdelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contactfolder-permanentdelete.md | + + Title: "contactFolder: permanentDelete" +description: "Permanently delete a contact folder and remove its items from the user's mailbox." ++ms.localizationpriority: high ++++# contactFolder: permanentDelete ++Namespace: microsoft.graph +++Permanently delete a contact folder and remove its items from the user's mailbox. For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help). ++>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox. +++## Permissions ++Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "contactfolder_permanentdelete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /users/{usersId}/contactFolders/{contactFolderId}/permanentDelete +POST /users/{usersId}/contactFolders/{contactFolderId}/childFolders/{contactFolderId}/permanentDelete +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "contactfolderthis.permanentdelete" +} +--> +``` http +POST https://graph.microsoft.com/beta/users/{usersId}/contactFolders/{contactFolderId}/permanentDelete +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Contentmodel Addtodrive | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-addtodrive.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/contentmodelthisaddtodrive-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/contentmodelthisaddtodrive-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Contentmodel Getapplieddrives | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-getapplieddrives.md | GET https://graph.microsoft.com/beta/sites/ede4bb84-6c94-4c39-8acf-3d9dbb667fba/ [!INCLUDE [sample-code](../includes/snippets/php/contentmodelthisgetapplieddrives-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/contentmodelthisgetapplieddrives-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Contentmodel Removefromdrive | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/contentmodel-removefromdrive.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/contentmodelthisremovefromdrive-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/contentmodelthisremovefromdrive-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Conversationmembers Add | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/conversationmembers-add.md | Title: "conversationMember: add" description: "Add members in bulk to a team."-+ doc_type: "apiPageType" ms.localizationpriority: high |
v1.0 | Daynote Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/daynote-delete.md | Delete a [day note](../resources/daynote.md) object. ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). +<!-- { "blockType": "permissions", "name": "daynote_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/daynote-delete-permissions.md)] ## HTTP request |
v1.0 | Daynote Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/daynote-get.md | Read the properties and relationships of a [day note](../resources/daynote.md) o ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). +<!-- { "blockType": "permissions", "name": "daynote_get" } --> [!INCLUDE [permissions-table](../includes/permissions/daynote-get-permissions.md)] ## HTTP request |
v1.0 | Daynote List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/daynote-list.md | Retrieve the properties and relationships of all [day notes](../resources/daynot ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). +<!-- { "blockType": "permissions", "name": "daynote_list" } --> [!INCLUDE [permissions-table](../includes/permissions/daynote-list-permissions.md)] ## HTTP request |
v1.0 | Devicelocalcredentialinfo Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/devicelocalcredentialinfo-get.md | To access the actual passwords on the device, done by including `$select=credent ## HTTP request To get the device local credential for a specific device object: -> [!CAUTION] -> The `GET /deviceLocalCredentials` endpoint will be deprecated on December 31, 2023. Use the `GET /directory/deviceLocalCredentials` endpoint instead. -> - <!-- { "blockType": "ignored" } --> ``` http GET /directory/deviceLocalCredentials/{deviceId}-GET /deviceLocalCredentials/{deviceId} ``` ## Request headers |
v1.0 | Directory List Devicelocalcredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directory-list-devicelocalcredentials.md | Choose the permission or permissions marked as least privileged for this API. Us ## HTTP request To get a list of deviceLocalCredentialInfo within the tenant: -> [!CAUTION] -> The `GET /deviceLocalCredentials` endpoint will be deprecated on December 31, 2023. Use the `GET /directory/deviceLocalCredentials` endpoint instead. - <!-- { "blockType": "ignored" } --> ``` http GET /directory/deviceLocalCredentials-GET /deviceLocalCredentials ``` ## Optional query parameters |
v1.0 | Directoryaudit Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directoryaudit-get.md | This method doesn't support any OData query parameters to help customize the res | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Directoryaudit List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/directoryaudit-list.md | This method supports the `$filter` (`eq`, `ge`, `le`, `startswith`), `$top`, `$o | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Domain List Rootdomain | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/domain-list-rootdomain.md | GET https://graph.microsoft.com/beta/domains/sub.contoso.com/rootDomain [!INCLUDE [sample-code](../includes/snippets/php/get-rootdomain-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/get-rootdomain-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Driveitem Discardcheckout | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-discardcheckout.md | POST https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/discardC [!INCLUDE [sample-code](../includes/snippets/php/driveitemthisdiscardcheckout-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + # [Python](#tab/python) [!INCLUDE [sample-code](../includes/snippets/python/driveitemthisdiscardcheckout-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Driveitem Getretentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-getretentionlabel.md | For information about retention labels from an administrator's perspective, see ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -| Permission type | Permissions (from least to most privileged) | -|:|:-| -| Delegated (work or school account) | Files.Read.All, Sites.Read.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Files.Read.All, Sites.Read.All | +<!-- { "blockType": "permissions", "name": "driveitem_getretentionlabel" } --> ## HTTP request |
v1.0 | Driveitem Lockorunlockrecord | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-lockorunlockrecord.md | For more information about how you can lock and unlock retention labels, see [Us ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Files.ReadWrite.All, Sites.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Files.ReadWrite.All, Sites.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "driveitem_lockorunlockrecord" } --> ## HTTP request |
v1.0 | Driveitem Removeretentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-removeretentionlabel.md | For information about retention labels from an administrator's perspective, see ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All, Sites.FullControl.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "driveitem_removeretentionlabel" } --> >**Note:** `Sites.FullControl.All` is the least privileged permission required to remove retention labels that classify the content as records. |
v1.0 | Driveitem Setretentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/driveitem-setretentionlabel.md | When a retention label is applied to a folder, all the items in the folder are t ## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -| Permission type | Permissions (from least to most privileged) | -|:|:--| -| Delegated (work or school account) | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All | -| Delegated (personal Microsoft account) | Not supported. | -| Application | Files.Read.All, Files.ReadWrite.All, Sites.ReadWrite.All | +<!-- { "blockType": "permissions", "name": "driveitem_setretentionlabel" } --> >**Note:** `Sites.FullControl.All` is the least privileged permission required to change retention labels that classify the content as records. |
v1.0 | Educationassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationassignment-get.md | Choose the permission or permissions marked as least privileged for this API. Us GET /education/classes/{id}/assignments/{id} ``` ## Optional query parameters-This method supports the `$select` and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select`, `$orderby`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++You can use `$orderby` with the following properties of the [educationAssignment](../resources/educationassignment.md) resource: **assignDateTime**, **assignedDateTime**, **closeDateTime**, **createdDateTime**, **displayName**, **dueDateTime**, **lastModifiedDateTime**, **moduleUrl**, and **status**. The following `$expand` options are available for this method: `categories`, `resources`, `rubric`, `submissions`, `gradingScheme`, `gradingCategory`, and `*`. `*` specifies all the previous options. |
v1.0 | Educationassignment Post Categories | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationassignment-post-categories.md | POST /education/classes/{id}/assignments/{id}/categories/$ref | Content-Type | application/json | ## Request body-In the request body, supply the odata.id of the existing [educationCategory](../resources/educationcategory.md) object(s) to add to this assignment. -+In the request body, supply the **odata.id** of an existing [educationCategory](../resources/educationcategory.md) object to add to this assignment. ## Response If successful, this method returns a `204 No Content` response code. ## Example-##### Request +### Request The following example shows a request.+# [HTTP](#tab/http) <!-- {- "blockType": "ignored", - "name": "add_educationcategory_to_educationassignment", - "sampleKeys": ["11021", "19002"] + "blockType": "request", + "name": "add_educationcategory_to_educationassignment" }--> ```http-POST https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/categories/$ref +POST https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/70b7077c-7c1c-4e56-9b3b-2365411900c6/categories/$ref Content-type: application/json {- "@odata.id": "https://graph.microsoft.com/v1.0/education/classes/11021/assignmentCategories/ec98f158-341d-4fea-9f8c-14a250d489ac" + "@odata.id": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentCategories/39e3d9dc-7244-42d7-8b4d-1071aae5eb41" }- ```-In the request body, supply the odata.id of the existing [educationCategory](../resources/educationcategory.md) object to add to this assignment. -##### Response -The following example shows the response. ->**Note:** The response object shown here might be shortened for readability. +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) +# [PowerShell](#tab/powershell) ++# [Python](#tab/python) ++++### Response +The following example shows the response. <!-- {- "blockType": "ignored", - "truncated": true, - "@odata.type": "microsoft.graph.educationAssignmentResource" + "blockType": "response", + "truncated": true } --> ```http HTTP/1.1 204 No Content ```+ <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- HTTP/1.1 204 No Content "suppressions": [] } -->-- |
v1.0 | Educationassignment Remove Category | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationassignment-remove-category.md | If successful, this method returns a `204 No Content` response code. ## Example ### Request The following example shows a request.+# [HTTP](#tab/http) <!-- {- "blockType": "ignored", - "name": "add_educationcategory_to_educationassignment", - "sampleKeys": ["11021", "19002", "ec98f158-341d-4fea-9f8c-14a250d489ac"] + "blockType": "request", + "name": "remove_educationcategory_from_educationassignment" }--> ```http-DELETE https://graph.microsoft.com/beta/education/classes/11021/assignments/19002/categories/ec98f158-341d-4fea-9f8c-14a250d489ac/$ref +DELETE https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignments/e98aaae1-7c98-4e65-bb62-1994fe410552/categories/39e3d9dc-7244-42d7-8b4d-1071aae5eb41/$ref ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++ ### Response The following example shows the response. <!-- {- "blockType": "ignored", - "truncated": true, - "@odata.type": "microsoft.graph.educationAssignmentResource" + "blockType": "response", + "truncated": true } --> ```http HTTP/1.1 204 No Content |
v1.0 | Educationcategory Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationcategory-delete.md | If successful, this method returns a `204 No Content` response code. It doesn't The following example shows a request. - # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "delete_educationassignment_2", - "sampleKeys": ["11014", "19002"] + "name": "delete_educationassignment_2" }--> ```http-DELETE https://graph.microsoft.com/beta/education/classes/11014/assignmentCategories/19002 +DELETE https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/assignmentCategories/39e3d9dc-7244-42d7-8b4d-1071aae5eb41 ``` # [C#](#tab/csharp) |
v1.0 | Educationcategory Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationcategory-get.md | GET /education/classes/{id}/assignmentCategories/{id} ## Optional query parameters -This method supports the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` and `$orderby` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++You can use `$orderby` with the **displayName** property of the [educationCategory](../resources/educationcategory.md) resource. ## Request headers | Header | Value | |
v1.0 | Educationclass Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationclass-delta.md | GET /education/classes/delta | Name | Description | | : | : |-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Educationclass Getrecentlymodifiedsubmissions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationclass-getrecentlymodifiedsubmissions.md | + + Title: "getRecentlyModifiedSubmissions: educationClass" +description: "Retrieve recently modified submissions. A submission object represents a student's work for an assignment." ++ms.localizationpriority: medium ++++# getRecentlyModifiedSubmissions: educationClass ++Namespace: microsoft.graph +++Retrieve submissions modified in the previous seven days. Only teachers and applications with application permissions can perform this operation. ++A **submission** object represents a student's work for an [assignment](../resources/educationassignment.md). Resources associated with the submission represent their work. ++A teacher or application with application permissions has full access to all **submission** objects. ++The grade and feedback from a teacher are part of the [educationOutcome](../resources/educationoutcome.md) associated with this object. Only teachers or applications with application permissions can add or change grades and feedback. Students can't see the grade or feedback until the **assignment** is released. +++## Permissions +Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "educationclass_getrecentlymodifiedsubmissions" } --> ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +GET /education/classes/{class-id}/getRecentlyModifiedSubmissions +``` ++## Optional query parameters +This method supports the `$orderby`, `$top`, `$filter`, `$select`, and `$expand` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++The `$orderby` query parameter only supports the **lastModifiedDateTime** property of the [educationSubmission](../resources/educationsubmission.md) resource. ++The default ordering is by descending **lastModifiedDateTime** property values. ++## Request headers +| Header | Value | +|:|:--| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body +Don't supply a request body for this method. ++## Response +If successful, this method returns a `200 OK` response code and a collection of [educationSubmission](../resources/educationsubmission.md) objects in the response body. ++If you specify an unsupported property for the `$orderby` query parameter, the method returns a `400` error message. ++```http +HTTP/1.1 400 Bad Request +Content-type: application/json ++{ + "error": { + "code": "20143", + "message": "The OData query is invalid. $orderby clause is only supported for these properties : (lastModifiedDateTime).", + "innerError": { + "date": "2024-08-27T13:04:10", + "request-id": "218ae0dc-664c-4928-b4e1-f3b37c27c472", + "client-request-id": "ed8c66ed-fd50-d7ec-d989-5a92140999c1" + } + } +} +``` +If you specify an unsupported value for the `$filter` query parameter, the method returns a `400` error message. ++```http +HTTP/1.1 400 Bad Request +Content-type: application/json ++{ + "error": { + "code": "BadRequest", + "message": "Invalid filter clause: The $filter expression must evaluate to a single boolean value.", + "innerError": { + "date": "2024-08-27T13:05:11", + "request-id": "31233bf3-c442-4a8d-a1ff-56c665239e25", + "client-request-id": "30f9e18f-f311-741b-bf48-23fd4feecdb9" + } + } +} +``` ++## Examples ++### Example 1: Get recently modified submissions ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_educationclass_getrecentlymodifiedsubmissions" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions +``` ++#### Response +The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.educationSubmission)" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime", + "value": [ + { + "status": "returned", + "submittedDateTime": null, + "unsubmittedDateTime": "2024-08-14T05:48:30.9345815Z", + "returnedDateTime": "2024-08-14T05:47:41.4128921Z", + "reassignedDateTime": "2024-08-14T05:47:18.3007671Z", + "excusedDateTime": "2024-08-14T05:47:41.4128921Z", + "lastModifiedDateTime": "2024-08-14T06:37:17.9779374Z", + "resourcesFolderUrl": null, + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%22bf1f1963-05f6-4cba-903c-5892b4ce3bd7%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%22db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%224bca096a-7de3-8675-5e86-2fa149923860%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "4bca096a-7de3-8675-5e86-2fa149923860", + "recipient": { + "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient", + "userId": "61243ddb-6f39-499d-b232-9fa8cef26b3a" + }, + "submittedBy": { + "application": null, + "device": null, + "user": { + "id": "61243ddb-6f39-499d-b232-9fa8cef26b3a", + "displayName": null + } + }, + "unsubmittedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "returnedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "reassignedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "excusedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + }, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null + } + } + } + ] +} +``` ++### Example 2: Get recently modified submissions with `$select` and `$filter` options on assignmentId property ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_educationclass_getrecentlymodifiedsubmissions_filter_select_assignmentId" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getrecentlymodifiedsubmissions?$filter=assignmentId eq 'b20d6737-f88e-4892-8174-73aa26d18784'&$select=LastModifiedDateTime,status +``` ++#### Response +The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.educationSubmission)" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)", + "value": [ + { + "status": "submitted", + "lastModifiedDateTime": "2024-09-09T10:18:33.4052415Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.6464644Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.588738Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.5295878Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.4718648Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.3513158Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.2866527Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.2219998Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.1602788Z" + }, + { + "status": "working", + "lastModifiedDateTime": "2024-09-09T10:18:07.0884058Z" + } + ] +} +``` ++### Example 3: Get recently modified submissions with `$expand` option ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_educationclass_getrecentlymodifiedsubmissions_expand" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getRecentlyModifiedSubmissions?$expand=outcomes +``` ++#### Response +The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.educationSubmission)" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime", + "value": [ + { + "status": "working", + "submittedDateTime": null, + "unsubmittedDateTime": null, + "returnedDateTime": null, + "reassignedDateTime": null, + "excusedDateTime": null, + "lastModifiedDateTime": "2024-08-26T20:45:51.3485047Z", + "resourcesFolderUrl": null, + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%2273b252e5-5f2c-42d6-8896-bfe924ce5fe9%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%225af42a11-37cc-c144-fa4c-7db855942011%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "5af42a11-37cc-c144-fa4c-7db855942011", + "recipient": { + "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient", + "userId": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29" + }, + "submittedBy": { + "application": null, + "device": null, + "user": { + "id": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29", + "displayName": null + } + }, + "unsubmittedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "returnedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "reassignedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "excusedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "7254e396-868c-4bf7-96b2-6fe763590b5a", + "displayName": null + } + }, + "outcomes": [ + { + "@odata.type": "#microsoft.graph.educationFeedbackOutcome", + "lastModifiedDateTime": null, + "id": "ca05367a-b292-42d5-aff7-5d279feeace8", + "lastModifiedBy": null, + "feedback": null, + "publishedFeedback": null + }, + { + "@odata.type": "#microsoft.graph.educationPointsOutcome", + "lastModifiedDateTime": null, + "id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8", + "lastModifiedBy": null, + "points": null, + "publishedPoints": null + } + ] + } + ] +} +``` ++### Example 4: Get recently modified submissions with `$filter` option ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_educationclass_getrecentlymodifiedsubmissions_filter" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$filter=status eq 'working' +``` ++#### Response +The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.educationSubmission)" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)", + "@odata.nextLink": "https://graph.microsoft.com/beta/education/classes/37d99af7-cfc5-4e3b-8566-f7d40e4a2070/getRecentlyModifiedSubmissions?$filter=status+eq+%27working%27&$skiptoken=eyJJbm5lclNraXBUb2tlbiI6Ik15WlJWa1pDVVZWR1FsRlZSa1phTVd4Q1VWVkdRbEZWUmtKU1JXeENVVlZHUWxWWFZscE9SM040U3pCc1RGWlRjM2RTTUhkNlZGVlJlRlJzUW1oa2VqQTUifQ%3d%3d", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime", + "value": [ + { + "status": "working", + "submittedDateTime": null, + "unsubmittedDateTime": null, + "returnedDateTime": null, + "reassignedDateTime": null, + "excusedDateTime": null, + "lastModifiedDateTime": "2024-08-26T15:57:23.5476513Z", + "resourcesFolderUrl": null, + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%223d2fcfd4-cb6a-4e31-aa63-16ca865e9014%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%227e2e0656-2bf4-1f95-b4b0-967f516340cd%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "7e2e0656-2bf4-1f95-b4b0-967f516340cd", + "recipient": { + "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient", + "userId": "80cefd93-8d88-40e2-b5d3-67898383e226" + }, + "submittedBy": { + "application": null, + "device": null, + "user": { + "id": "80cefd93-8d88-40e2-b5d3-67898383e226", + "displayName": null + } + }, + "unsubmittedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "returnedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "reassignedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "excusedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346", + "displayName": null + } + } + } + ] +} +``` ++### Example 5: Get recently modified submissions with `$orderby` and `$top` options ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_educationclass_getrecentlymodifiedsubmissions_orderby_top" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$orderby=lastModifiedDateTime&$top=1 +``` ++#### Response +The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.educationSubmission)" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime", + "value": [ + { + "status": "working", + "submittedDateTime": null, + "unsubmittedDateTime": null, + "returnedDateTime": null, + "reassignedDateTime": null, + "excusedDateTime": null, + "lastModifiedDateTime": "2024-08-26T15:57:23.2992323Z", + "resourcesFolderUrl": null, + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%223d2fcfd4-cb6a-4e31-aa63-16ca865e9014%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%223b03a85c-6021-8e5c-fc07-c4ac6d3506d3%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "3b03a85c-6021-8e5c-fc07-c4ac6d3506d3", + "recipient": { + "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient", + "userId": "2d20b7fc-43bd-459c-81e0-5eb4aa20d5b5" + }, + "submittedBy": { + "application": null, + "device": null, + "user": { + "id": "2d20b7fc-43bd-459c-81e0-5eb4aa20d5b5", + "displayName": null + } + }, + "unsubmittedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "returnedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "reassignedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "excusedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "5e3ce6c0-2b1f-4285-8d4b-75ee78787346", + "displayName": null + } + } + } + ] +} +``` ++### Example 6: Get recently modified submissions with `$select` option ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_educationclass_getrecentlymodifiedsubmissions_select" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$select=excusedDateTime +``` ++#### Response +The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.educationSubmission)" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)", + "value": [ + { + "excusedDateTime": "2024-08-26T16:00:17.535348Z" + }, + { + "excusedDateTime": "2024-08-26T16:00:17.4698345Z" + }, + { + "excusedDateTime": null + } + ] +} +``` +### Example 7: Get recently modified submissions with `$filter` option for a range on lastModifiedDateTime property ++#### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_educationclass_getrecentlymodifiedsubmissions_filter_range" +}--> +```msgraph-interactive +GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/getRecentlyModifiedSubmissions?$filter=lastModifiedDateTime gt 2024-08-25T20:45:51.3485047Z and lastModifiedDateTime lt 2024-08-28T20:45:51.3485047Z +``` ++#### Response +The following example shows the response. ++>**Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "Collection(microsoft.graph.educationSubmission)" +} --> +```http +HTTP/1.1 200 OK +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.educationSubmission)", + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET education/classes('<guid>')/microsoft.graph.getRecentlyModifiedSubmissions?$select=excusedBy,excusedDateTime", + "value": [ + { + "status": "working", + "submittedDateTime": null, + "unsubmittedDateTime": null, + "returnedDateTime": null, + "reassignedDateTime": null, + "excusedDateTime": null, + "lastModifiedDateTime": "2024-08-26T20:45:51.3485047Z", + "resourcesFolderUrl": null, + "webUrl": "https://teams.microsoft.com/l/entity/66aeee93-507d-479a-a3ef-8f494af43945/classroom?context=%7B%22subEntityId%22%3A%22%7B%5C%22version%5C%22%3A%5C%221.0%5C%22,%5C%22config%5C%22%3A%7B%5C%22classes%5C%22%3A%5B%7B%5C%22id%5C%22%3A%5C%2237d99af7-cfc5-4e3b-8566-f7d40e4a2070%5C%22,%5C%22assignmentIds%5C%22%3A%5B%5C%2273b252e5-5f2c-42d6-8896-bfe924ce5fe9%5C%22%5D,%5C%22submissionId%5C%22%3A%5C%225af42a11-37cc-c144-fa4c-7db855942011%5C%22%7D%5D%7D,%5C%22action%5C%22%3A%5C%22navigate%5C%22,%5C%22view%5C%22%3A%5C%22speed-grader%5C%22,%5C%22appId%5C%22%3A%5C%22de8bc8b5-d9f9-48b1-a8ad-b748da725064%5C%22%7D%22,%22channelId%22%3Anull%7D", + "id": "5af42a11-37cc-c144-fa4c-7db855942011", + "recipient": { + "@odata.type": "#microsoft.graph.educationSubmissionIndividualRecipient", + "userId": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29" + }, + "submittedBy": { + "application": null, + "device": null, + "user": { + "id": "e5c17181-ad7e-4a66-86bf-b560ce0c8b29", + "displayName": null + } + }, + "unsubmittedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "returnedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "reassignedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "excusedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null + } + }, + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": "7254e396-868c-4bf7-96b2-6fe763590b5a", + "displayName": null + } + } + } + ] +} +``` ++<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 +2024-08-18 14:57:30 UTC --> +<!-- +{ + "type": "#page.annotation", + "description": "Get educationSubmission recentlymodifiedsubmission", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [] +} +--> |
v1.0 | Educationfeedbackresourceoutcome Post Outcomes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationfeedbackresourceoutcome-post-outcomes.md | HTTP/1.1 201 Created Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes/$entity", + "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('37d99af7-cfc5-4e3b-8566-f7d40e4a2070')/assignments('a3cce0ba-2008-4c4d-bf62-079408562d96')/submissions('2185e6d7-2924-4ed1-dde1-269f89e29184')/outcomes/$entity", "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",- "lastModifiedDateTime": "2022-05-06T00:50:30.0772434Z", - "id": "ba12f282-2190-4958-80b3-42b8afb9626a", + "lastModifiedDateTime": "2024-08-14T06:50:11.6979503Z", + "id": "b7e92489-91b6-4734-ab5c-b1370862e4a2", "resourceStatus": "notPublished", "lastModifiedBy": { "application": null, "device": null, "user": {- "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, "feedbackResource": { "@odata.type": "#microsoft.graph.educationWordResource", "displayName": "Document1.docx",- "createdDateTime": "2022-05-06T00:50:30.0772177Z", - "lastModifiedDateTime": "2022-05-06T00:50:30.0772434Z", - "fileUrl": "https://graph.microsoft.com/beta/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQZQ33I4AJBSURHZJDDQKEJ5TEMJ", + "createdDateTime": "2024-08-14T06:50:11.6979432Z", + "lastModifiedDateTime": "2024-08-14T06:50:11.6979503Z", + "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQZ6GPYK2SPEXRDKILMSBSL5KNKM", "createdBy": { "application": null, "device": null, "user": {- "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } }, Content-type: application/json "application": null, "device": null, "user": {- "id": "cb1a4af3-0aba-4679-aa12-9f99bab0b61a", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", "displayName": null } } |
v1.0 | Educationoutcome Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationoutcome-update.md | The following example shows a request to update a feedback outcome. }--> ```http-PATCH https://graph.microsoft.com/beta/education/classes/{id}/assignments/{id}/submissions/{id}/outcomes/{id} +PATCH https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/outcomes/ca05367a-b292-42d5-aff7-5d279feeace8 Content-type: application/json { HTTP/1.1 200 OK Content-type: application/json {+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('bf1f1963-05f6-4cba-903c-5892b4ce3bd7')/assignments('db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a')/submissions('4bca096a-7de3-8675-5e86-2fa149923860')/outcomes/$entity", "@odata.type": "#microsoft.graph.educationFeedbackOutcome",+ "lastModifiedDateTime": "2024-08-14T06:37:17.7703021Z", "id": "ca05367a-b292-42d5-aff7-5d279feeace8",+ "publishedFeedback": null, "lastModifiedBy": {+ "application": null, + "device": null, "user": {- "id": "9391878d-903c-406c-bb1c-0f17d00fd878" + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null } }, "feedback": {- "feedbackDateTime": "2019-07-31T21:10:30.3231461Z", + "feedbackDateTime": "2024-08-14T06:37:17.7703021Z", "text": { "content": "This is feedback for the assignment as a whole.", "contentType": "text" }, "feedbackBy": {+ "application": null, + "device": null, "user": {- "id": "9391878d-903c-406c-bb1c-0f17d00fd878", + "id": "fffafb29-e8bc-4de3-8106-be76ed2ad499", + "displayName": null } } } |
v1.0 | Educationschool Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationschool-delta.md | GET /education/schools/delta | Name | Description | | : | : |-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Educationsubmission Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsubmission-get.md | GET /education/classes/{class-id}/assignments/{assignment-id}/submissions/{submi ## Optional query parameters -This method supports the `$select` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). +This method supports the `$select` and `$orderby` OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters). ++You can use `$orderby` with the following properties of the [educationSubmission](../resources/educationsubmission.md) resource: **excusedDateTime**, **reassignedDateTime**, **returnedDateTime**, **status**, **submittedDateTime**, and **unsubmittedDateTime**. ## Request headers | Header | Value | |
v1.0 | Educationsubmission List Outcomes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsubmission-list-outcomes.md | The following example shows a request. }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/education/classes/{id}/assignments/{id}/submissions/{id}/outcomes +GET https://graph.microsoft.com/beta/education/classes/bf1f1963-05f6-4cba-903c-5892b4ce3bd7/assignments/db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a/submissions/4bca096a-7de3-8675-5e86-2fa149923860/outcomes ``` # [C#](#tab/csharp) HTTP/1.1 200 OK Content-type: application/json {+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#education/classes('bf1f1963-05f6-4cba-903c-5892b4ce3bd7')/assignments('db8e6b0b-dba4-4c69-81b2-9ba7313c0b7a')/submissions('4bca096a-7de3-8675-5e86-2fa149923860')/outcomes", "value": [ { "@odata.type": "#microsoft.graph.educationFeedbackOutcome",+ "lastModifiedDateTime": null, "id": "ca05367a-b292-42d5-aff7-5d279feeace8",- "feedback": { - "feedbackDateTime": "2019-07-15T22:35:46.4847754Z", - "text": { - "content": "This is feedback for the assignment as a whole.", - "contentType": "text" - }, - "feedbackBy": { - "user": { - "id": "9391878d-903c-406c-bb1c-0f17d00fd878" - } + "lastModifiedBy": null, + "feedback": null, + "publishedFeedback": null + }, + { + "@odata.type": "#microsoft.graph.educationPointsOutcome", + "lastModifiedDateTime": null, + "id": "ea1351f6-ba33-4940-b2cb-6a7254af2dc8", + "lastModifiedBy": null, + "points": null, + "publishedPoints": null + }, + { + "@odata.type": "#microsoft.graph.educationRubricOutcome", + "lastModifiedDateTime": "2024-08-14T05:47:41.8399565Z", + "id": "65a46d78-1a2b-4a7e-bcf8-78a22ac2611b", + "lastModifiedBy": { + "application": null, + "device": null, + "user": { + "id": null, + "displayName": null } },- "publishedFeedback": { - "feedbackDateTime": "2019-07-15T22:35:46.4847754Z", - "text": { - "content": "This is feedback for the assignment as a whole.", - "contentType": "text" + "rubricQualityFeedback": [ + { + "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9", + "feedback": null },- "feedbackBy": { - "user": { - "id": "9391878d-903c-406c-bb1c-0f17d00fd878" - } + { + "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0", + "feedback": null + }, + { + "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa", + "feedback": null }- } + ], + "rubricQualitySelectedLevels": [ + { + "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9", + "columnId": null + }, + { + "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0", + "columnId": null + }, + { + "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa", + "columnId": null + } + ], + "publishedRubricQualityFeedback": [ + { + "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9", + "feedback": null + }, + { + "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0", + "feedback": null + }, + { + "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa", + "feedback": null + } + ], + "publishedRubricQualitySelectedLevels": [ + { + "qualityId": "6b9eccdd-ae31-474d-9ab5-33ba885873f9", + "columnId": null + }, + { + "qualityId": "0fdf030a-2e52-4ea4-b321-74091cef90b0", + "columnId": null + }, + { + "qualityId": "8fdacfb6-0e28-4bce-9153-3196fbcc0eaa", + "columnId": null + } + ] } ] } Content-type: application/json "value": [ { "@odata.type": "#microsoft.graph.educationFeedbackResourceOutcome",- "lastModifiedDateTime": "2022-05-06T00:52:12.8318457Z", - "id": "8fb409c5-570b-4fe5-8473-d3666e61f3a0", + "lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z", + "id": "0710aeea-590d-46b4-9eb8-1c08b6549677", "resourceStatus": "notPublished", "lastModifiedBy": { "application": null, Content-type: application/json }, "feedbackResource": { "@odata.type": "#microsoft.graph.educationWordResource",- "displayName": "Document2.docx", - "createdDateTime": "2022-05-06T00:52:12.8318064Z", - "lastModifiedDateTime": "2022-05-06T00:52:12.8318457Z", - "fileUrl": "https://graph.microsoft.com/beta/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ26WF6K2W2IOFAKDITG4F5GWRH5", + "displayName": "Document3.docx", + "createdDateTime": "2022-05-06T00:52:17.3180176Z", + "lastModifiedDateTime": "2022-05-06T00:52:17.3180275Z", + "fileUrl": "https://graph.microsoft.com/v1.0/drives/b!-Ik2sRPLDEWy_bR8l75jfeDcpXQcRKVOmcml10NQLQ1F8CNZWU38SarWxPyWM7jx/items/01VANVJQ563EMEMHRTBBH2SOZ4GDSNEUZK", "createdBy": { "application": null, "device": null, |
v1.0 | Educationsubmission Reassign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationsubmission-reassign.md | The following is an example of the response when `Prefer: include-unknown-enum-m <!-- { "blockType": "response",+ "truncated": true, "@odata.type": "microsoft.graph.educationSubmission" } --> ```http Prefer: include-unknown-enum-members The following is an example of the response when `Prefer: include-unknown-enum-members` is provided in the request header and the submission hasn't been returned before. <!-- {- "blockType": "response", + "blockType": "response", + "truncated": true, "@odata.type": "microsoft.graph.educationSubmission" } --> ```http |
v1.0 | Educationuser Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationuser-delta.md | GET /education/users/delta | Name | Description | | : | : |-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Educationuser List Assignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/educationuser-list-assignments.md | This method supports the `$top`, `$filter`, `$orderby`, and `$select` OData quer The following `$expand` options are available for this method: `categories`, `resources`, `gradingCategory`, `rubric`, `submissions`, and `*`, which includes all the previous options. -All [properties](../resources/educationassignment.md#properties) are supported for the query parameters `$filter` and `$orderby`. +All [properties](../resources/educationassignment.md#properties) are supported by the `$filter` query parameter. ++You can use `$orderby` with the following properties of the [educationAssignment](../resources/educationassignment.md) resource: **assignDateTime**, **assignedDateTime**, **closeDateTime**, **createdDateTime**, **displayName**, **dueDateTime**, **lastModifiedDateTime**, and **status**. ## Request headers |
v1.0 | Entitlementmanagement Post Assignmentrequests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/entitlementmanagement-post-assignmentrequests.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -In [Microsoft Entra Entitlement Management](../resources/entitlementmanagement-overview.md), create a new [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object. This operation is used to assign a user to an access package, update the assignment, or to remove an access package assignment. +In [Microsoft Entra Entitlement Management](../resources/entitlementmanagement-overview.md), create a new [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object. This operation is used to assign a user to an access package, update the assignment, or to remove an access package assignment. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] For a non-administrator user to request to update their own assignments, the val If successful, this method returns a 200-series response code and a new [accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) object in the response body. -If this is an `adminAdd` request, then subsequently an [accessPackageAssignment](../resources/accesspackageassignment.md) and, if needed, an [accessPackageSubject](../resources/accesspackagesubject.md) are also created. You can locate those using the query parameters when [listing accessPackageAssignments](entitlementmanagement-list-accesspackageassignments.md). +If the request type is `adminAdd` for this request, then an [accessPackageAssignment](../resources/accesspackageassignment.md) and, if needed, an [accessPackageSubject](../resources/accesspackagesubject.md) are also created. You can locate those objects using the query parameters when [listing accessPackageAssignments](entitlementmanagement-list-accesspackageassignments.md). ## Examples Content-type: application/json } ``` -### Example 5: Admin requests a direct assignment for a user not yet in the directory +### Example 5: Request a package on behalf of a direct employee ++The following example shows how a manager can request an access package assignment on behalf of their direct employee. ++> [!NOTE] +> The requestor (manager) is extracted from the token, and the target object is determined by the `id` of the direct employee who is receiving access. ++#### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "update_accesspackageassignmentrequest_request_behalf" +}--> +```http +POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/assignmentRequests +Content-type: application/json ++{ + "assignment": { + "accessPackageId": "5b98f958-0dea-4a5b-836e-109dccbd530c", + "schedule": { + "startDateTime": null, + "stopDateTime": null + }, + "assignmentPolicyId": "c5f7847f-83a8-4315-a754-d94a6f39b875", + "target": { + "displayName": "Idris Ibrahim", + "email": "IdrisIbrahim@woodgrovebank.com", + "objectId": "21aceaba-fe13-4e3b-aa8c-4c588d5e7387", + "subjectType": "user" + } + }, + "justification": "Access for direct employee", + "requestType": "UserAdd", + "answers": [] +} +``` ++#### Response ++The following example shows the response. ++> **Note:** The response object shown here might be shortened for readability. All the properties are returned from an actual call. ++<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.accessPackageAssignmentRequest" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/entitlementManagement/assignmentRequests/$entity", + "id": "445a3118-6bf2-4a19-94ad-5660295963fd", + "requestType": "userAdd", + "state": "submitted", + "status": "Accepted", + "createdDateTime": null, + "completedDateTime": null, + "schedule": { + "startDateTime": null, + "recurrence": null, + "expiration": { + "endDateTime": null, + "duration": null, + "type": "notSpecified" + } + }, + "answers": [], + "customExtensionCalloutInstances": [] +} +``` +++### Example 6: Admin requests a direct assignment for a user not yet in the directory #### Request Content-type: application/json } ``` -### Example 6: Request an update to answers for an assignment +### Example 7: Request an update to answers for an assignment The following example shows how an admin can request updates to an assignment to edit their responses to questions that were answered during the request for the assignment. Content-type: application/json }--> -### Example 7: Update the expiration date for an access package assignment +### Example 8: Update the expiration date for an access package assignment The following example shows how to update the expiration date for an access package assignment. |
v1.0 | Event Permanentdelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/event-permanentdelete.md | + + Title: "event: permanentDelete" +description: "Permanently delete an event and place it in the Purges folder in the dumpster in the user's mailbox." ++ms.localizationpriority: high ++++# event: permanentDelete ++Namespace: microsoft.graph +++Permanently delete an event and place it in the Purges folder in the dumpster in the user's mailbox. Email clients such as Outlook or the Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time. ++For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help). ++>**Note:** Folders aren't placed in the Purges folder when they are permanently deleted. Permanently deleted folders are removed from the mailbox. +++## Permissions ++Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "event_permanentdelete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /users/{usersId}/events/{eventId}/permanentDelete +POST /groups/{groupsId}/events/{eventId}/permanentDelete +POST /users/{usersId}/calendarView/{eventId}/permanentDelete +POST /groups/{groupsId}/calendarView/{eventId}/permanentDelete +POST /users/{usersId}/messages/{messageId}/event/permanentDelete +POST /users/{usersId}/messages/{messageId}/event/instances/{eventId}/permanentDelete +POST /users/{usersId}/messages/{messageId}/event/calendar/events/{eventId}/permanentDelete +POST /users/{usersId}/messages/{messageId}/event/exceptionOccurrences/{eventId}/permanentDelete +POST /users/{usersId}/messages/{messageId}/event/calendar/calendarView/{eventId}/permanentDelete +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "eventthis.permanentdelete" +} +--> +``` http +POST https://graph.microsoft.com/beta/users/{usersId}/events/{eventId}/permanentDelete +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Eventmessage Permanentdelete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/eventmessage-permanentdelete.md | + + Title: "eventMessage: permanentDelete" +description: "Permanently delete an event message and place it in the Purges folder in the user's mailbox." ++ms.localizationpriority: high ++++# eventMessage: permanentDelete ++Namespace: microsoft.graph +++Permanently delete an event message and place it in the Purges folder in the user's mailbox. Email clients such as Outlook or the Outlook on the web can't access permanently deleted items. Unless there's a hold set on the mailbox, the items are permanently deleted after a set period of time. ++For more information about item retention, see [Configure Deleted Item retention and Recoverable Items quotas](/exchange/configure-deleted-item-retention-and-recoverable-items-quotas-exchange-2013-help). ++++## Permissions ++Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). ++<!-- { "blockType": "permissions", "name": "eventmessage_permanentdelete" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /me/messages/{id}/permanentDelete +POST /users/{id | userPrincipalName}/messages/{id}/permanentDelete +POST /me/mailFolders/{id}/messages/{id}/permanentDelete +POST /users/{id | userPrincipalName}/mailFolders/{id}/messages/{id}/permanentDelete +``` ++## Request headers ++|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ++## Request body ++Don't supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++### Request ++The following example shows a request. +# [HTTP](#tab/http) +<!-- { + "blockType": "request", + "name": "eventmessagethis.permanentdelete" +} +--> +``` http +POST https://graph.microsoft.com/beta/me/messages/{id}/permanentDelete +``` ++# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
v1.0 | Exchangeprotectionpolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangeprotectionpolicy-update.md | To remove a **mailboxProtectionUnit** from the policy, specify the `@removed` an If successful, this method returns a `200 OK` response code and an updated [exchangeProtectionPolicy](../resources/exchangeprotectionpolicy.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Exchangerestoresession List Mailboxrestoreartifacts | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangerestoresession-list-mailboxrestoreartifacts.md | Don't supply a request body for this method. If successful, this method returns a `200 OK` response code and a collection of [mailboxRestoreArtifact](../resources/mailboxrestoreartifact.md) objects in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Exchangerestoresession Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/exchangerestoresession-update.md | To remove an **exchangeRestoreSession**, specify the @removed annotation in the If successful, this method returns a `200 OK` response code and an updated [exchangeRestoreSession](../resources/exchangerestoresession.md) object in the response body. +For a list of possible error responses, see [Backup Storage API error responses](/graph/backup-storage-error-codes). + ## Examples ### Request |
v1.0 | Externalauthenticationmethodconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-delete.md | Delete an [externalAuthenticationMethodConfiguration](../resources/externalauthe Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "externalauthenticationmethodconfiguration-delete-permissions" -} >+<!-- { "blockType": "permissions", "name": "externalauthenticationmethodconfiguration_delete" } --> [!INCLUDE [permissions-table](../includes/permissions/externalauthenticationmethodconfiguration-delete-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)] |
v1.0 | Externalauthenticationmethodconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-get.md | Read the properties and relationships of an [externalAuthenticationMethodConfigu Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "externalauthenticationmethodconfiguration-get-permissions" -} >+<!-- { "blockType": "permissions", "name": "externalauthenticationmethodconfiguration_get" } --> [!INCLUDE [permissions-table](../includes/permissions/externalauthenticationmethodconfiguration-get-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-read](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-read.md)] |
v1.0 | Externalauthenticationmethodconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/externalauthenticationmethodconfiguration-update.md | Update the properties of an [externalAuthenticationMethodConfiguration](../resou Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "externalauthenticationmethodconfiguration-update-permissions" -} >+<!-- { "blockType": "permissions", "name": "externalauthenticationmethodconfiguration_update" } --> [!INCLUDE [permissions-table](../includes/permissions/externalauthenticationmethodconfiguration-update-permissions.md)] [!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)] |
v1.0 | Fido2authenticationmethod Creationoptions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/fido2authenticationmethod-creationoptions.md | Retrieve creation options required to generate and register a Microsoft Entra ID Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { - "blockType": "permissions", - "name": "fido2authenticationmethod-creationoptions-permissions" -} >+<!-- { "blockType": "permissions", "name": "fido2authenticationmethod_creationoptions" } --> [!INCLUDE [permissions-table](../includes/permissions/fido2authenticationmethod-creationoptions-permissions.md)] [!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)] Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-GET /users/{usersId}/authentication/fido2Methods/creationOptions +GET /users/{user-id}/authentication/fido2Methods/creationOptions(challengeTimeoutInMinutes={challengeTimeoutInMinutes}) ``` ## Function parameters GET https://graph.microsoft.com/beta/users/{usersId}/authentication/fido2Methods [!INCLUDE [sample-code](../includes/snippets/javascript/fido2authenticationmethodthiscreationoptions-javascript-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] +# [PowerShell](#tab/powershell) + ### Response Content-Type: application/json { "value": {- "@odata.type": "microsoft.graph.webauthnCredentialCreationOptions" + "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.webauthnCredentialCreationOptions", + "challengeTimeoutDateTime": "2024-08-14T16:29:58Z", + "publicKey": { + "challenge": "ZXlKaGJHY2lPaUpTVTBFdFQwRkZVQzB5TlRZaUxDSmxibU1pT2lKQk1qVTJSME5OSWl3aWVEVmpJanBiSWsxSlNVUmhSRU5EUVd4...", + "timeout": 0, + "attestation": "direct", + "rp": { + "id": "login.microsoft.com", + "name": "Microsoft" + }, + "user": { + "id": "T0Y6Ehqp2EfQP0iExdt54DFwdWuaH7qIZbZGpOc92RGnvbXyRPvU-8AOp9r1T7Cebfc3", + "displayName": "Kim User", + "name": "kimuser@contoso.com" + }, + "pubKeyCredParams": [ + { + "type": "public-key", + "alg": -7 + }, + { + "type": "public-key", + "alg": -257 + } + ], + "excludeCredentials": [ + { + "id": "0S64X8KwFmCeJjHzK1oE/39T+JYhfYbhFurwOxMMjtvRWc/sLYq8AMJVuva823XQ", + "type": "public-key", + "transports": [] + }, + { + "id": "pgIfj2fnom8rJdb4/h1gKqDkq+gxHFksI+m2aR5T+PNNycBfENAM4ksEBvoXky6d", + "type": "public-key", + "transports": [] + }, + { + "id": "u5wuw6SGH0VhAz7OXCLRkCuxhm4UrCB7hcLccyMU6calP1hWexfKe5PJNM69neAM", + "type": "public-key", + "transports": [] + }, + { + "id": "6rc0zTSz2YRlaKlCjqxsNDjDe8qY8TSL95Z4WhxEaaP4XfvfSnAGMk49RSwm/uAO", + "type": "public-key", + "transports": [] + } + ], + "authenticatorSelection": { + "authenticatorAttachment": "cross-platform", + "requireResidentKey": true, + "userVerification": "required" + }, + "extensions": { + "hmacCreateSecret": true, + "enforceCredentialProtectionPolicy": true, + "credentialProtectionPolicy": "userVerificationOptional" + } + } } } ``` |
v1.0 | Governanceresource Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceresource-get.md | This method **only** supports `$select` and `$expand` [OData Query Parameters]( ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governanceresource List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceresource-list.md | This method supports the [OData query parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governanceroleassignment Export | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignment-export.md | This method supports the [OData query parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governanceroleassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignment-get.md | This method does **not** supports [OData Query Parameters](/graph/query-paramete ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governanceroleassignment List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignment-list.md | This method supports the [OData Query Parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governanceroleassignmentrequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-get.md | This method supports the [OData Query Parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governanceroleassignmentrequest List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-list.md | This method supports the [OData query parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governanceroleassignmentrequest Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-post.md | POST /privilegedAccess/azureResources/roleAssignmentRequests | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| | Content-type | application/json | ## Request body |
v1.0 | Governanceroleassignmentrequest Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroleassignmentrequest-update.md | POST /privilegedAccess/azureResources/roleAssignmentRequests/{id}/updateRequest ## Request headers | Name | Description| |:|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| | Content-type | application/json| ## Request body |
v1.0 | Governanceroledefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroledefinition-get.md | This method does **not** support the [OData Query Parameters](/graph/query-param ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Governanceroledefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governanceroledefinition-list.md | This method supports the [OData query parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governancerolesetting Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governancerolesetting-get.md | This method supports the [OData Query Parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Governancerolesetting List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/governancerolesetting-list.md | This method supports the [OData query parameters](/graph/query-parameters) to he ## Request headers | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body Don't supply a request body for this method. |
v1.0 | Group Assignlicense | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-assignlicense.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Add or remove licenses on the group. Licenses assigned to the group will be assigned to all users in the group. To learn more about group-based licensing, see [What is group-based licensing in Microsoft Entra ID](/azure/active-directory/fundamentals/active-directory-licensing-whatis-azure-portal). +Add or remove licenses on the group. Licenses assigned to the group will be assigned to all users in the group. Group-based licensing is an alternative to [direct user licensing](../api/user-assignlicense.md). To learn more about group-based licensing, see [What is group-based licensing in Microsoft Entra ID](/azure/active-directory/fundamentals/active-directory-licensing-whatis-azure-portal). To get the subscriptions available in the directory, perform a [GET subscribedSkus request](subscribedsku-list.md). |
v1.0 | Group Post Groups | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-post-groups.md | The following table lists the properties that are required when you create the [ > [!IMPORTANT] >-> - Creating a group using the **Group.Create** application permission without specifying owners will create the group anonymously and the group will not be modifiable. Add owners to the group while creating it to specify owners who can modify the group. +> - Creating a group using the **Group.Create** application permission without specifying owners creates the group anonymously and the group isn't modifiable. Add owners to the group while creating it so the owners can manage the group. >-> - Creating a Microsoft 365 group programmatically with an app-only context and without specifying owners will create the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken. +> - Creating a Microsoft 365 group in an app-only context and without specifying owners creates the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken. +> +> - Creating a Microsoft 365 or security group in a delegated context, signed in as a non-admin user, and without specifying owners automatically adds the calling user as the group owner. An admin user is automatically added as the group owner of a Microsoft 365 group they create but not of a security group. +> +> - A non-admin user can't add themselves to the group owners collection. For more information, see the related [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=26419). > > - To following properties can't be set in the initial POST request and must be set in a subsequent PATCH request: **allowExternalSenders**, **autoSubscribeNewMembers**, **hideFromAddressLists**, **hideFromOutlookClients**, **isSubscribedByMail**, **unseenCount**. Content-type: application/json The following example creates a security group with an owner and members specified. Note that a maximum of 20 relationships, such as owners and members, can be added as part of group creation. You can subsequently add more members by using the [add member](/graph/api/group-post-members?view=graph-rest-beta&preserve-view=true) API or JSON batching. +A non-admin user can't add themselves to the group owners collection. For more information, see the related [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=26419). + #### Request The following example shows a request. |
v1.0 | Group Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-update.md | The following table specifies the properties that can be updated. | Property | Type | Description | | :- | : | :- | | allowExternalSenders | Boolean | Default is `false`. Indicates whether people external to the organization can send messages to the group. |-| assignedLabels | [assignedLabel](../resources/assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group.| +| assignedLabels | [assignedLabel](../resources/assignedlabel.md) collection | The list of sensitivity label pairs (label ID, label name) associated with a Microsoft 365 group. This property can be updated only in delegated scenarios where the caller requires both the Microsoft Graph permission and [a supported administrator role](/purview/get-started-with-sensitivity-labels#permissions-required-to-create-and-manage-sensitivity-labels).| | autoSubscribeNewMembers | Boolean | Default is `false`. Indicates whether new members added to the group will be auto-subscribed to receive email notifications. **autoSubscribeNewMembers** can't be `true` when **subscriptionEnabled** is set to `false` on the group. | | description | String | An optional description for the group. | | displayName | String | The display name for the group. This property is required when a group is created and it cannot be cleared during updates. | |
v1.0 | Group Upsert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-upsert.md | The following table lists the properties that are required when you create the [ > [!IMPORTANT] > - Creating a group using the **Group.Create** application permission without specifying owners will create the group anonymously and the group will not be modifiable. Add owners to the group while creating it to specify owners who can modify the group. > - Creating a Microsoft 365 group programmatically with an app-only context and without specifying owners will create the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.+> - A non-admin user can't add themselves to the group owners collection. For more information, see the related [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=26419). > - The following properties can't be set in the initial POST request and must be set in a subsequent PATCH request: **allowExternalSenders**, **autoSubscribeNewMembers**, **hideFromAddressLists**, **hideFromOutlookClients**, **isSubscribedByMail**, **unseenCount**. Because the **group** resource supports [extensions](/graph/extensibility-overview), you can add custom properties with your own data to the group while creating it. Content-type: application/json The following example creates a security group with an owner and members specified because a group with the specified **uniqueName** value does not exist. Note that a maximum of 20 relationships, such as owners and members, can be added as part of group creation. You can subsequently add multiple additional members by using the [add member](/graph/api/group-post-members?view=graph-rest-beta&preserve-view=true) API or JSON batching. +A non-admin user can't add themselves to the group owners collection. For more information, see the related [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=26419). + #### Request The following example shows a request. Content-type: application/json In this example, the specified group already exists, so the operation is treated as an update. +A non-admin user can't add themselves to the group owners collection. For more information, see the related [known issue](https://developer.microsoft.com/en-us/graph/known-issues/?search=26419). + #### Request The following example shows a request. |
v1.0 | Group Validateproperties | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/group-validateproperties.md | POST /groups/{id}/validateProperties | Name | Description | | : | : |-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| | Content-Type | application/json | ## Request body |
v1.0 | Identitycontainer List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-list-identityproviders.md | Content-type: application/json #### Request The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_identityproviderbase_CIAM" The following example shows a request. GET https://graph.microsoft.com/beta/identity/identityProviders ``` +# [C#](#tab/csharp) ++# [CLI](#tab/cli) ++# [Go](#tab/go) ++# [Java](#tab/java) ++# [JavaScript](#tab/javascript) ++# [PHP](#tab/php) ++# [PowerShell](#tab/powershell) ++# [Python](#tab/python) +++ #### Response The following example shows the response. Content-type: application/json } ] }-``` +``` |
v1.0 | Identitycontainer Post Authenticationeventsflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitycontainer-post-authenticationeventsflows.md | You can specify the following properties when creating an **authenticationEvents |priority|Int32|Optional. The priority to use for each individual event of the events policy. If multiple competing listeners for an event have the same priority, one is chosen and an error is silently logged. Default is 500. | |onInteractiveAuthFlowStart|[onInteractiveAuthFlowStartHandler](../resources/oninteractiveauthflowstarthandler.md)|Required. The configuration for what to invoke when an authentication flow is ready to be initiated. | |onAuthenticationMethodLoadStart|[onAuthenticationMethodLoadStartHandler](../resources/onauthenticationmethodloadstarthandler.md)|Required. The configuration for what to invoke when authentication methods are ready to be presented to the user. Must have at least one identity provider linked.|-|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|Optional. The configuration for what to invoke when attributes are ready to be collected from the user. To configure this property when it wasn't configured during user flow creation, call the [Add attributes to a user flow](../api/onattributecollectionexternalusersselfservicesignup-post-attributes.md) API.| +|onAttributeCollection|[onAttributeCollectionHandler](../resources/onattributecollectionhandler.md)|Optional. The configuration for what to invoke when attributes are ready to be collected from the user. To configure this property, you must specify both **attributes** and **onAttributeCollectionPage** > **views** objects.| |onUserCreateStart|[onUserCreateStartHandler](../resources/onusercreatestarthandler.md)|Optional. The configuration for what to invoke during user creation.| ## Response |
v1.0 | Identitygovernance Deleteditemcontainer Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-deleteditemcontainer-delete.md | Delete a [workflow](../resources/identitygovernance-workflow.md) object. Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). -<!-- { "blockType": "permissions", "name": "identitygovernance_deletedItemcontainer_delete" } --> +<!-- { "blockType": "permissions", "name": "identitygovernance_deleteditemcontainer_delete" } --> [!INCLUDE [rbac-lifecycle-workflows-apis-write](../includes/rbac-for-apis/rbac-lifecycle-workflows-apis-write.md)] |
v1.0 | Identitygovernance Insights Toptasksprocessedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-toptasksprocessedsummary.md | Namespace: microsoft.graph.identityGovernance Provide a summary of the most processed tasks, known as top tasks, for a specified time period in a tenant. The task definition is provided, along with numerical counts of total, successful, and failed runs. For information about workflows processed, see [insights: topWorkflowsProcessedSummary](identitygovernance-insights-topworkflowsprocessedsummary.md). + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-toptasksprocessedsummary-permissions.md)] + ## HTTP request <!-- { Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-GET /identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary +GET /identityGovernance/lifecycleWorkflows/insights/topTasksProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime}) ``` ## Function parameters |
v1.0 | Identitygovernance Insights Topworkflowsprocessedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-topworkflowsprocessedsummary.md | Namespace: microsoft.graph.identityGovernance Provide a summary of the workflows processed the most, known as top workflows, for a specified period in a tenant. Workflow basic details are given, along with run information. For information about tasks processed, see [insights: topTasksProcessedSummary](identitygovernance-insights-toptasksprocessedsummary.md). + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-topworkflowsprocessedsummary-permissions.md)] + ## HTTP request <!-- { Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-GET /identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary +GET /identityGovernance/lifecycleWorkflows/insights/topWorkflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime}) ``` ## Function parameters |
v1.0 | Identitygovernance Insights Workflowsprocessedbycategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-workflowsprocessedbycategory.md | Namespace: microsoft.graph.identityGovernance Provide a summary of workflows processed, by category, in a tenant. This allows you to quickly get category information, by numerical value, bypassing other information found in the [WorkflowsProcessedSummary](identitygovernance-insights-workflowsprocessedsummary.md) call. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-workflowsprocessedbycategory-permissions.md)] + ## HTTP request <!-- { Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory +GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedByCategory(startDateTime={startDateTime},endDateTime={endDateTime}) ``` ## Function parameters |
v1.0 | Identitygovernance Insights Workflowsprocessedsummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-insights-workflowsprocessedsummary.md | Namespace: microsoft.graph.identityGovernance Provide a summary of all workflows processed within a tenant for a specified period. Because the amount of results for listed workflows as returned by the [List workflows](../api/identitygovernance-lifecycleworkflowscontainer-list-workflows.md) does not tell you which workflows were processed from the list of created workflows, this summary gives you a quick overview of processed status based on counts. + ## Permissions Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference). Choose the permission or permissions marked as least privileged for this API. Us --> [!INCLUDE [permissions-table](../includes/permissions/identitygovernance-insights-workflowsprocessedsummary-permissions.md)] + ## HTTP request <!-- { Choose the permission or permissions marked as least privileged for this API. Us } --> ``` http-GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary +GET /identityGovernance/lifecycleWorkflows/insights/workflowsProcessedSummary(startDateTime={startDateTime},endDateTime={endDateTime}) ``` ## Function parameters |
v1.0 | Identitygovernance Lifecycleworkflowscontainer List Taskdefinitions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md | Title: "List taskDefinitions" -description: "Get a list of the taskDefinition objects and their properties." +description: "Get a list of built-in workflow tasks in Lifecycle Workflows." ms.localizationpriority: medium Namespace: microsoft.graph.identityGovernance [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get a list of the [taskDefinition](../resources/identitygovernance-taskdefinition.md) objects and their properties. +Get a list of built-in workflow tasks in Lifecycle Workflows. A task is represented by the [taskDefinition](../resources/identitygovernance-taskdefinition.md) object. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] GET https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/taskD #### Response The following example shows the response.+<!-- Keep the full response object for this example for other internal purposes--> <!-- { "blockType": "response", Content-Type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/lifecycleWorkflows/taskDefinitions",- "@odata.count": 25, + "@odata.count": 24, + "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET identityGovernance/lifecycleWorkflows/taskDefinitions?$select=category,continueOnError", "value": [ { "category": "joiner,leaver,mover", Content-Type: application/json }, { "category": "leaver",- "description": "Send offboarding email to userΓÇÖs manager before the last day of work", - "displayName": "Send email before userΓÇÖs last day", + "description": "Send offboarding email to user's manager before the last day of work", + "displayName": "Send email before user's last day", "id": "52853a3e-f4e5-4eb8-bb24-1ac09a1da935", "version": 1, "parameters": [ Content-Type: application/json }, { "category": "leaver",- "description": "Send offboarding email to userΓÇÖs manager on the last day of work", - "displayName": "Send email on userΓÇÖs last day", + "description": "Send offboarding email to user's manager on the last day of work", + "displayName": "Send email on user's last day", "id": "9c0a1eaf-5bda-4392-9d9e-6e155bb57411", "version": 1, "parameters": [ Content-Type: application/json }, { "category": "leaver",- "description": "Send offboarding email to userΓÇÖs manager after the last day of work", - "displayName": "Send email after userΓÇÖs last day", + "description": "Send offboarding email to user's manager after the last day of work", + "displayName": "Send email after user's last day", "id": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce", "version": 1, "parameters": [ Content-Type: application/json }, { "category": "joiner",- "description": "Send onboarding reminder email to userΓÇÖs manager", + "description": "Send onboarding reminder email to user's manager", "displayName": "Send onboarding reminder email", "id": "3C860712-2D37-42A4-928F-5C93935D26A1", "version": 1, Content-Type: application/json }, { "category": "mover",- "description": "Send email to notify userΓÇÖs manager of user move", + "description": "Send email to notify user's manager of user move", "displayName": "Send email to notify manager of user move", "id": "aab41899-9972-422a-9d97-f626014578b7", "version": 1, Content-Type: application/json "valueType": "string" } ]- }, - { - "category": "leaver,mover", - "description": "Transfer groups the user owned to the user's manager", - "displayName": "Transfer group ownership to manager", - "id": "dde2a64c-8420-447b-9075-7309449de5cd", - "version": 1, - "parameters": [] } ] } |
v1.0 | Identitygovernance Taskdefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/identitygovernance-taskdefinition-get.md | Title: "Get taskDefinition" -description: "Read the details of a built-in workflow task." +description: "Read the details of a built-in workflow task in Lifecycle Workflows." ms.localizationpriority: medium Namespace: microsoft.graph.identityGovernance [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Read the details of a built-in workflow [task](../resources/identitygovernance-taskdefinition.md). +Read the details of a built-in workflow [task](../resources/identitygovernance-taskdefinition.md) in Lifecycle Workflows. [!INCLUDE [national-cloud-support](../../includes/global-us.md)] |
v1.0 | Intune Androidforwork Androiddeviceownerenrollmentprofile Clearenrollmenttimedevicemembershiptarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-clearenrollmenttimedevicemembershiptarget.md | + + Title: "clearEnrollmentTimeDeviceMembershipTarget action" +description: "Intune Androidforwork Androiddeviceownerenrollmentprofile Clearenrollmenttimedevicemembershiptarget Api ." ++ms.localizationpriority: medium ++++# clearEnrollmentTimeDeviceMembershipTarget action ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}/clearEnrollmentTimeDeviceMembershipTarget +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this action returns a `204 No Content` response code. ++## Example ++### Request +Here is an example of the request. +``` http +POST https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}/clearEnrollmentTimeDeviceMembershipTarget +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 204 No Content +``` |
v1.0 | Intune Androidforwork Androiddeviceownerenrollmentprofile Retrieveenrollmenttimedevicemembershiptarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-retrieveenrollmenttimedevicemembershiptarget.md | + + Title: "retrieveEnrollmentTimeDeviceMembershipTarget action" +description: "Intune Androidforwork Androiddeviceownerenrollmentprofile Retrieveenrollmenttimedevicemembershiptarget Api ." ++ms.localizationpriority: medium ++++# retrieveEnrollmentTimeDeviceMembershipTarget action ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}/retrieveEnrollmentTimeDeviceMembershipTarget +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-shared-enrollmenttimedevicemembershiptargetresult.md) in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +POST https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}/retrieveEnrollmentTimeDeviceMembershipTarget +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 455 ++{ + "value": { + "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetResult", + "validationSucceeded": true, + "enrollmentTimeDeviceMembershipTargetValidationStatuses": [ + { + "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetStatus", + "targetId": "Target Id value", + "validationSucceeded": true, + "targetValidationErrorCode": "securityGroupNotFound" + } + ] + } +} +``` |
v1.0 | Intune Androidforwork Androiddeviceownerenrollmentprofile Setenrollmenttimedevicemembershiptarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-androidforwork-androiddeviceownerenrollmentprofile-setenrollmenttimedevicemembershiptarget.md | + + Title: "setEnrollmentTimeDeviceMembershipTarget action" +description: "Intune Androidforwork Androiddeviceownerenrollmentprofile Setenrollmenttimedevicemembershiptarget Api ." ++ms.localizationpriority: medium ++++# setEnrollmentTimeDeviceMembershipTarget action ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +POST /deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}/setEnrollmentTimeDeviceMembershipTarget +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +In the request body, supply JSON representation of the parameters. ++The following table shows the parameters that can be used with this action. ++|Property|Type|Description| +|:|:|:| +|enrollmentTimeDeviceMembershipTargets|[enrollmentTimeDeviceMembershipTarget](../resources/intune-shared-enrollmenttimedevicemembershiptarget.md) collection|| ++++## Response +If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-shared-enrollmenttimedevicemembershiptargetresult.md) in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +POST https://graph.microsoft.com/beta/deviceManagement/androidDeviceOwnerEnrollmentProfiles/{androidDeviceOwnerEnrollmentProfileId}/setEnrollmentTimeDeviceMembershipTarget ++Content-type: application/json +Content-length: 228 ++{ + "enrollmentTimeDeviceMembershipTargets": [ + { + "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTarget", + "targetType": "staticSecurityGroup", + "targetId": "Target Id value" + } + ] +} +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 455 ++{ + "value": { + "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetResult", + "validationSucceeded": true, + "enrollmentTimeDeviceMembershipTargetValidationStatuses": [ + { + "@odata.type": "microsoft.graph.enrollmentTimeDeviceMembershipTargetStatus", + "targetId": "Target Id value", + "validationSucceeded": true, + "targetValidationErrorCode": "securityGroupNotFound" + } + ] + } +} +``` |
v1.0 | Intune Apps Androidlobapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidlobapp-create.md | Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json-Content-length: 1472 +Content-length: 1532 { "@odata.type": "#microsoft.graph.androidLobApp", Content-length: 1472 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1644 +Content-Length: 1704 { "@odata.type": "#microsoft.graph.androidLobApp", Content-Length: 1644 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Androidlobapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidlobapp-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1769 +Content-Length: 1835 { "value": { Content-Length: 1769 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Androidlobapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidlobapp-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1889 +Content-Length: 1961 { "value": [ Content-Length: 1889 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Androidlobapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidlobapp-update.md | Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json-Content-length: 1472 +Content-length: 1532 { "@odata.type": "#microsoft.graph.androidLobApp", Content-length: 1472 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1644 +Content-Length: 1704 { "@odata.type": "#microsoft.graph.androidLobApp", Content-Length: 1644 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Androidstoreapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-create.md | The following table shows the properties that are required when you create the a |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. This property is read-only. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. This property is read-only. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |packageId|String|The package identifier. This property is read-only.|-|appIdentifier|String|The Identity Name. This property is read-only.| |appStoreUrl|String|The Android app store URL.| |minimumSupportedOperatingSystem|[androidMinimumOperatingSystem](../resources/intune-apps-androidminimumoperatingsystem.md)|The value for the minimum applicable operating system.| Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json-Content-length: 1327 +Content-length: 1343 { "@odata.type": "#microsoft.graph.androidStoreApp", Content-length: 1327 "supersedingAppCount": 3, "supersededAppCount": 2, "packageId": "Package Id value",- "appIdentifier": "App Identifier value", "appStoreUrl": "https://example.com/appStoreUrl/", "minimumSupportedOperatingSystem": { "@odata.type": "microsoft.graph.androidMinimumOperatingSystem", Content-length: 1327 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1499 +Content-Length: 1515 { "@odata.type": "#microsoft.graph.androidStoreApp", Content-Length: 1499 "supersedingAppCount": 3, "supersededAppCount": 2, "packageId": "Package Id value",- "appIdentifier": "App Identifier value", "appStoreUrl": "https://example.com/appStoreUrl/", "minimumSupportedOperatingSystem": { "@odata.type": "microsoft.graph.androidMinimumOperatingSystem", Content-Length: 1499 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` |
v1.0 | Intune Apps Androidstoreapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1616 +Content-Length: 1636 { "value": { Content-Length: 1616 "supersedingAppCount": 3, "supersededAppCount": 2, "packageId": "Package Id value",- "appIdentifier": "App Identifier value", "appStoreUrl": "https://example.com/appStoreUrl/", "minimumSupportedOperatingSystem": { "@odata.type": "microsoft.graph.androidMinimumOperatingSystem", Content-Length: 1616 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } } |
v1.0 | Intune Apps Androidstoreapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1728 +Content-Length: 1752 { "value": [ Content-Length: 1728 "supersedingAppCount": 3, "supersededAppCount": 2, "packageId": "Package Id value",- "appIdentifier": "App Identifier value", "appStoreUrl": "https://example.com/appStoreUrl/", "minimumSupportedOperatingSystem": { "@odata.type": "microsoft.graph.androidMinimumOperatingSystem", Content-Length: 1728 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ] |
v1.0 | Intune Apps Androidstoreapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-androidstoreapp-update.md | The following table shows the properties that are required when you create the [ |supersedingAppCount|Int32|The total number of apps this app directly or indirectly supersedes. This property is read-only. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |supersededAppCount|Int32|The total number of apps this app is directly or indirectly superseded by. This property is read-only. Inherited from [mobileApp](../resources/intune-shared-mobileapp.md)| |packageId|String|The package identifier. This property is read-only.|-|appIdentifier|String|The Identity Name. This property is read-only.| |appStoreUrl|String|The Android app store URL.| |minimumSupportedOperatingSystem|[androidMinimumOperatingSystem](../resources/intune-apps-androidminimumoperatingsystem.md)|The value for the minimum applicable operating system.| Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json-Content-length: 1327 +Content-length: 1343 { "@odata.type": "#microsoft.graph.androidStoreApp", Content-length: 1327 "supersedingAppCount": 3, "supersededAppCount": 2, "packageId": "Package Id value",- "appIdentifier": "App Identifier value", "appStoreUrl": "https://example.com/appStoreUrl/", "minimumSupportedOperatingSystem": { "@odata.type": "microsoft.graph.androidMinimumOperatingSystem", Content-length: 1327 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1499 +Content-Length: 1515 { "@odata.type": "#microsoft.graph.androidStoreApp", Content-Length: 1499 "supersedingAppCount": 3, "supersededAppCount": 2, "packageId": "Package Id value",- "appIdentifier": "App Identifier value", "appStoreUrl": "https://example.com/appStoreUrl/", "minimumSupportedOperatingSystem": { "@odata.type": "microsoft.graph.androidMinimumOperatingSystem", Content-Length: 1499 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` |
v1.0 | Intune Apps Managedandroidlobapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-create.md | Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json-Content-length: 1550 +Content-length: 1610 { "@odata.type": "#microsoft.graph.managedAndroidLobApp", Content-length: 1550 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1722 +Content-Length: 1782 { "@odata.type": "#microsoft.graph.managedAndroidLobApp", Content-Length: 1722 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Managedandroidlobapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1851 +Content-Length: 1917 { "value": { Content-Length: 1851 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Managedandroidlobapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1975 +Content-Length: 2047 { "value": [ Content-Length: 1975 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Managedandroidlobapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidlobapp-update.md | Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json-Content-length: 1550 +Content-length: 1610 { "@odata.type": "#microsoft.graph.managedAndroidLobApp", Content-length: 1550 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1722 +Content-Length: 1782 { "@odata.type": "#microsoft.graph.managedAndroidLobApp", Content-Length: 1722 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true }, "versionName": "Version Name value", "versionCode": "Version Code value", |
v1.0 | Intune Apps Managedandroidstoreapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-create.md | Here is an example of the request. ``` http POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps Content-type: application/json-Content-length: 1361 +Content-length: 1421 { "@odata.type": "#microsoft.graph.managedAndroidStoreApp", Content-length: 1361 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 201 Created Content-Type: application/json-Content-Length: 1533 +Content-Length: 1593 { "@odata.type": "#microsoft.graph.managedAndroidStoreApp", Content-Length: 1533 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` |
v1.0 | Intune Apps Managedandroidstoreapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-get.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1652 +Content-Length: 1718 { "value": { Content-Length: 1652 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } } |
v1.0 | Intune Apps Managedandroidstoreapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-list.md | Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1766 +Content-Length: 1838 { "value": [ Content-Length: 1766 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ] |
v1.0 | Intune Apps Managedandroidstoreapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-managedandroidstoreapp-update.md | Here is an example of the request. ``` http PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId} Content-type: application/json-Content-length: 1361 +Content-length: 1421 { "@odata.type": "#microsoft.graph.managedAndroidStoreApp", Content-length: 1361 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` Here is an example of the response. Note: The response object shown here may be ``` http HTTP/1.1 200 OK Content-Type: application/json-Content-Length: 1533 +Content-Length: 1593 { "@odata.type": "#microsoft.graph.managedAndroidStoreApp", Content-Length: 1533 "v8_1": true, "v9_0": true, "v10_0": true,- "v11_0": true + "v11_0": true, + "v12_0": true, + "v13_0": true, + "v14_0": true } } ``` |
v1.0 | Intune Apps Mobileappdependency Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappdependency-create.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+POST /deviceAppManagement/mobileAppRelationships POST /deviceAppManagement/mobileApps/{mobileAppId}/relationships ``` The following table shows the properties that are required when you create the m |Property|Type|Description| |:|:|:|-|id|String|The relationship entity id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetId|String|The target mobile app's app id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayName|String|The target mobile app's display name. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayVersion|String|The target mobile app's display version. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetPublisher|String|The target mobile app's publisher. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target is a parent or child. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`.| -|dependencyType|[mobileAppDependencyType](../resources/intune-apps-mobileappdependencytype.md)|The type of dependency relationship between the parent and child apps. Possible values are: `detect`, `autoInstall`.| -|dependentAppCount|Int32|The total number of apps that directly or indirectly depend on the parent app. This property is read-only.| -|dependsOnAppCount|Int32|The total number of apps the child app directly or indirectly depends on. This property is read-only.| +|id|String|The unique identifier for the mobile app relationship entity. Read-Only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetId|String|App ID of the app that is the target of the mobile app relationship entity. Read-Only Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayName|String|The display name of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayVersion|String|The display version of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetPublisher|String|The publisher of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target application of a relationship is a parent or child in the relationship. Possible values are: parent, child. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`, `unknownFutureValue`.| +|dependencyType|[mobileAppDependencyType](../resources/intune-apps-mobileappdependencytype.md)|The type of dependency relationship between the parent and child apps. Possible values are: detect, autoInstall. Read-Only. Possible values are: `detect`, `autoInstall`, `unknownFutureValue`.| +|dependentAppCount|Int32|The total number of apps that directly or indirectly depend on the parent app. Read-Only. This property is read-only.| +|dependsOnAppCount|Int32|The total number of apps the child app directly or indirectly depends on. Read-Only. This property is read-only.| If successful, this method returns a `201 Created` response code and a [mobileAp ### Request Here is an example of the request. ``` http-POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships +POST https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships Content-type: application/json Content-length: 372 |
v1.0 | Intune Apps Mobileappdependency Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappdependency-delete.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+DELETE /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} DELETE /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} ``` If successful, this method returns a `204 No Content` response code. ### Request Here is an example of the request. ``` http-DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} +DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} ``` ### Response |
v1.0 | Intune Apps Mobileappdependency Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappdependency-get.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} GET /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} ``` If successful, this method returns a `200 OK` response code and [mobileAppDepend ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} +GET https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} ``` ### Response |
v1.0 | Intune Apps Mobileappdependency List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappdependency-list.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceAppManagement/mobileAppRelationships GET /deviceAppManagement/mobileApps/{mobileAppId}/relationships ``` If successful, this method returns a `200 OK` response code and a collection of ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships +GET https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships ``` ### Response |
v1.0 | Intune Apps Mobileappdependency Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappdependency-update.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+PATCH /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} PATCH /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} ``` The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:|-|id|String|The relationship entity id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetId|String|The target mobile app's app id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayName|String|The target mobile app's display name. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayVersion|String|The target mobile app's display version. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetPublisher|String|The target mobile app's publisher. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target is a parent or child. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`.| -|dependencyType|[mobileAppDependencyType](../resources/intune-apps-mobileappdependencytype.md)|The type of dependency relationship between the parent and child apps. Possible values are: `detect`, `autoInstall`.| -|dependentAppCount|Int32|The total number of apps that directly or indirectly depend on the parent app. This property is read-only.| -|dependsOnAppCount|Int32|The total number of apps the child app directly or indirectly depends on. This property is read-only.| +|id|String|The unique identifier for the mobile app relationship entity. Read-Only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetId|String|App ID of the app that is the target of the mobile app relationship entity. Read-Only Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayName|String|The display name of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayVersion|String|The display version of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetPublisher|String|The publisher of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target application of a relationship is a parent or child in the relationship. Possible values are: parent, child. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`, `unknownFutureValue`.| +|dependencyType|[mobileAppDependencyType](../resources/intune-apps-mobileappdependencytype.md)|The type of dependency relationship between the parent and child apps. Possible values are: detect, autoInstall. Read-Only. Possible values are: `detect`, `autoInstall`, `unknownFutureValue`.| +|dependentAppCount|Int32|The total number of apps that directly or indirectly depend on the parent app. Read-Only. This property is read-only.| +|dependsOnAppCount|Int32|The total number of apps the child app directly or indirectly depends on. Read-Only. This property is read-only.| If successful, this method returns a `200 OK` response code and an updated [mobi ### Request Here is an example of the request. ``` http-PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} +PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} Content-type: application/json Content-length: 372 |
v1.0 | Intune Apps Mobileapprelationship Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapprelationship-get.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} GET /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} ``` If successful, this method returns a `200 OK` response code and [mobileAppRelati ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} +GET https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} ``` ### Response |
v1.0 | Intune Apps Mobileapprelationship List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileapprelationship-list.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceAppManagement/mobileAppRelationships GET /deviceAppManagement/mobileApps/{mobileAppId}/relationships ``` If successful, this method returns a `200 OK` response code and a collection of ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships +GET https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships ``` ### Response |
v1.0 | Intune Apps Mobileappsupersedence Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappsupersedence-create.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+POST /deviceAppManagement/mobileAppRelationships POST /deviceAppManagement/mobileApps/{mobileAppId}/relationships ``` The following table shows the properties that are required when you create the m |Property|Type|Description| |:|:|:|-|id|String|The relationship entity id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetId|String|The target mobile app's app id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayName|String|The target mobile app's display name. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayVersion|String|The target mobile app's display version. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetPublisher|String|The target mobile app's publisher. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target is a parent or child. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`.| -|supersedenceType|[mobileAppSupersedenceType](../resources/intune-apps-mobileappsupersedencetype.md)|The supersedence relationship type between the parent and child apps. Possible values are: `update`, `replace`.| -|supersededAppCount|Int32|The total number of apps directly or indirectly superseded by the child app. This property is read-only.| -|supersedingAppCount|Int32|The total number of apps directly or indirectly superseding the parent app. This property is read-only.| +|id|String|The unique identifier for the mobile app relationship entity. Read-Only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetId|String|App ID of the app that is the target of the mobile app relationship entity. Read-Only Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayName|String|The display name of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayVersion|String|The display version of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetPublisher|String|The publisher of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target application of a relationship is a parent or child in the relationship. Possible values are: parent, child. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`, `unknownFutureValue`.| +|supersedenceType|[mobileAppSupersedenceType](../resources/intune-apps-mobileappsupersedencetype.md)|The supersedence relationship type between the parent and child apps. Possible values are: update, replace. Read-Only. Possible values are: `update`, `replace`, `unknownFutureValue`.| +|supersededAppCount|Int32|The total number of apps directly or indirectly superseded by the child app. Read-Only. This property is read-only.| +|supersedingAppCount|Int32|The total number of apps directly or indirectly superseding the parent app. Read-Only. This property is read-only.| If successful, this method returns a `201 Created` response code and a [mobileAp ### Request Here is an example of the request. ``` http-POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships +POST https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships Content-type: application/json Content-length: 375 |
v1.0 | Intune Apps Mobileappsupersedence Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappsupersedence-delete.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+DELETE /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} DELETE /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} ``` If successful, this method returns a `204 No Content` response code. ### Request Here is an example of the request. ``` http-DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} +DELETE https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} ``` ### Response |
v1.0 | Intune Apps Mobileappsupersedence Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappsupersedence-get.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} GET /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} ``` If successful, this method returns a `200 OK` response code and [mobileAppSupers ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} +GET https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} ``` ### Response |
v1.0 | Intune Apps Mobileappsupersedence List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappsupersedence-list.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+GET /deviceAppManagement/mobileAppRelationships GET /deviceAppManagement/mobileApps/{mobileAppId}/relationships ``` If successful, this method returns a `200 OK` response code and a collection of ### Request Here is an example of the request. ``` http-GET https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships +GET https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships ``` ### Response |
v1.0 | Intune Apps Mobileappsupersedence Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-apps-mobileappsupersedence-update.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http+PATCH /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} PATCH /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} ``` The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:|-|id|String|The relationship entity id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetId|String|The target mobile app's app id. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayName|String|The target mobile app's display name. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetDisplayVersion|String|The target mobile app's display version. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetPublisher|String|The target mobile app's publisher. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| -|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target is a parent or child. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`.| -|supersedenceType|[mobileAppSupersedenceType](../resources/intune-apps-mobileappsupersedencetype.md)|The supersedence relationship type between the parent and child apps. Possible values are: `update`, `replace`.| -|supersededAppCount|Int32|The total number of apps directly or indirectly superseded by the child app. This property is read-only.| -|supersedingAppCount|Int32|The total number of apps directly or indirectly superseding the parent app. This property is read-only.| +|id|String|The unique identifier for the mobile app relationship entity. Read-Only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetId|String|App ID of the app that is the target of the mobile app relationship entity. Read-Only Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayName|String|The display name of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetDisplayVersion|String|The display version of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetPublisher|String|The publisher of the app that is the target of the mobile app relationship entity. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md)| +|targetType|[mobileAppRelationshipType](../resources/intune-apps-mobileapprelationshiptype.md)|The type of relationship indicating whether the target application of a relationship is a parent or child in the relationship. Possible values are: parent, child. Read-Only. This property is read-only. Inherited from [mobileAppRelationship](../resources/intune-apps-mobileapprelationship.md). Possible values are: `child`, `parent`, `unknownFutureValue`.| +|supersedenceType|[mobileAppSupersedenceType](../resources/intune-apps-mobileappsupersedencetype.md)|The supersedence relationship type between the parent and child apps. Possible values are: update, replace. Read-Only. Possible values are: `update`, `replace`, `unknownFutureValue`.| +|supersededAppCount|Int32|The total number of apps directly or indirectly superseded by the child app. Read-Only. This property is read-only.| +|supersedingAppCount|Int32|The total number of apps directly or indirectly superseding the parent app. Read-Only. This property is read-only.| If successful, this method returns a `200 OK` response code and an updated [mobi ### Request Here is an example of the request. ``` http-PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId} +PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId} Content-type: application/json Content-length: 375 |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Connect | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-connect.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-create.md | Namespace: microsoft.graph Create a new [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-delete.md | Namespace: microsoft.graph Deletes a [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Disconnect | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-disconnect.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-get.md | Namespace: microsoft.graph Read properties and relationships of the [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-list.md | Namespace: microsoft.graph List properties and relationships of the [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Chromebooksync Chromeosonboardingsettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-chromebooksync-chromeosonboardingsettings-update.md | Namespace: microsoft.graph Update the properties of a [chromeOSOnboardingSettings](../resources/intune-chromebooksync-chromeosonboardingsettings.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Deviceconfigv2 Devicemanagementcompliancepolicy Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementcompliancepolicy-assign.md | - Title: "assign action" -description: "Intune Deviceconfigv2 Devicemanagementcompliancepolicy Assign Api ." ---doc_type: apiPageType ---# assign action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assign -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|| ----## Response -If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assign --Content-type: application/json -Content-length: 610 --{ - "assignments": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 604 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assign.md | - Title: "assign action" -description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assign Api ." ---doc_type: apiPageType ---# assign action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign -POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assign -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|| ----## Response -If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assign --Content-type: application/json -Content-length: 610 --{ - "assignments": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 604 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assignjustintimeconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-assignjustintimeconfiguration.md | - Title: "assignJustInTimeConfiguration action" -description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Assignjustintimeconfiguration Api ." ---doc_type: apiPageType ---# assignJustInTimeConfiguration action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration -POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|justInTimeAssignments|[deviceManagementConfigurationJustInTimeAssignmentPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationjustintimeassignmentpolicy.md)|| ----## Response -If successful, this action returns a `200 OK` response code and a Boolean in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignJustInTimeConfiguration --Content-type: application/json -Content-length: 221 --{ - "justInTimeAssignments": { - "@odata.type": "microsoft.graph.deviceManagementConfigurationJustInTimeAssignmentPolicy", - "targetType": "entraSecurityGroup", - "target": [ - "Target value" - ] - } -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 21 --{ - "value": true -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Retrieveenrollmenttimedevicemembershiptarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-retrieveenrollmenttimedevicemembershiptarget.md | POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySet Do not supply a request body for this method. ## Response-If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-deviceconfigv2-enrollmenttimedevicemembershiptargetresult.md) in the response body. +If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-shared-enrollmenttimedevicemembershiptargetresult.md) in the response body. ## Example |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Retrievejustintimeconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-retrievejustintimeconfiguration.md | - Title: "retrieveJustInTimeConfiguration action" -description: "Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Retrievejustintimeconfiguration Api ." ---doc_type: apiPageType ---# retrieveJustInTimeConfiguration action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/retrieveJustInTimeConfiguration -POST /deviceManagement/reusablePolicySettings/{deviceManagementReusablePolicySettingId}/referencingConfigurationPolicies/{deviceManagementConfigurationPolicyId}/retrieveJustInTimeConfiguration -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationJustInTimeAssignmentPolicy](../resources/intune-deviceconfigv2-devicemanagementconfigurationjustintimeassignmentpolicy.md) in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/retrieveJustInTimeConfiguration -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 205 --{ - "value": { - "@odata.type": "microsoft.graph.deviceManagementConfigurationJustInTimeAssignmentPolicy", - "targetType": "entraSecurityGroup", - "target": [ - "Target value" - ] - } -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicy Setenrollmenttimedevicemembershiptarget | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicy-setenrollmenttimedevicemembershiptarget.md | The following table shows the parameters that can be used with this action. |Property|Type|Description| |:|:|:|-|enrollmentTimeDeviceMembershipTargets|[enrollmentTimeDeviceMembershipTarget](../resources/intune-deviceconfigv2-enrollmenttimedevicemembershiptarget.md) collection|| +|enrollmentTimeDeviceMembershipTargets|[enrollmentTimeDeviceMembershipTarget](../resources/intune-shared-enrollmenttimedevicemembershiptarget.md) collection|| ## Response-If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-deviceconfigv2-enrollmenttimedevicemembershiptargetresult.md) in the response body. +If successful, this action returns a `200 OK` response code and a [enrollmentTimeDeviceMembershipTargetResult](../resources/intune-shared-enrollmenttimedevicemembershiptargetresult.md) in the response body. ## Example |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-create.md | - Title: "Create deviceManagementConfigurationPolicyAssignment" -description: "Create a new deviceManagementConfigurationPolicyAssignment object." ---doc_type: apiPageType ---# Create deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments -POST /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments -POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceManagementConfigurationPolicyAssignment object. --The following table shows the properties that are required when you create the deviceManagementConfigurationPolicyAssignment. --|Property|Type|Description| -|:|:|:| -|id|String|The key of the assignment.| -|target|[deviceAndAppManagementAssignmentTarget](../resources/intune-shared-deviceandappmanagementassignmenttarget.md)|The assignment target for the DeviceManagementConfigurationPolicy.| -|source|[deviceAndAppManagementAssignmentSource](../resources/intune-shared-deviceandappmanagementassignmentsource.md)|The assignment source for the device compliance policy, direct or parcel/policySet. Possible values are: `direct`, `policySets`.| -|sourceId|String|The identifier of the source of the assignment.| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments -Content-type: application/json -Content-length: 478 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 527 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-delete.md | - Title: "Delete deviceManagementConfigurationPolicyAssignment" -description: "Deletes a deviceManagementConfigurationPolicyAssignment." ---doc_type: apiPageType ---# Delete deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -DELETE /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-get.md | - Title: "Get deviceManagementConfigurationPolicyAssignment" -description: "Read properties and relationships of the deviceManagementConfigurationPolicyAssignment object." ---doc_type: apiPageType ---# Get deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -GET /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 568 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-list.md | - Title: "List deviceManagementConfigurationPolicyAssignments" -description: "List properties and relationships of the deviceManagementConfigurationPolicyAssignment objects." ---doc_type: apiPageType ---# List deviceManagementConfigurationPolicyAssignments --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments -GET /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments -GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 604 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationpolicyassignment Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment-update.md | - Title: "Update deviceManagementConfigurationPolicyAssignment" -description: "Update the properties of a deviceManagementConfigurationPolicyAssignment object." ---doc_type: apiPageType ---# Update deviceManagementConfigurationPolicyAssignment --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -PATCH /deviceManagement/compliancePolicies/{deviceManagementCompliancePolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object. --The following table shows the properties that are required when you create the [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md). --|Property|Type|Description| -|:|:|:| -|id|String|The key of the assignment.| -|target|[deviceAndAppManagementAssignmentTarget](../resources/intune-shared-deviceandappmanagementassignmenttarget.md)|The assignment target for the DeviceManagementConfigurationPolicy.| -|source|[deviceAndAppManagementAssignmentSource](../resources/intune-shared-deviceandappmanagementassignmentsource.md)|The assignment source for the device compliance policy, direct or parcel/policySet. Possible values are: `direct`, `policySets`.| -|sourceId|String|The identifier of the source of the assignment.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assignments/{deviceManagementConfigurationPolicyAssignmentId} -Content-type: application/json -Content-length: 478 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 527 --{ - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base| |rootDefinitionId|String|Root setting definition id if the setting is a child setting.| |categoryId|String|Specify category in which the setting is under. Support $filters.|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information.| |id|String|Identifier for item| |description|String|Description of the setting.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingdefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingdefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettingdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base| |rootDefinitionId|String|Root setting definition id if the setting is a child setting.| |categoryId|String|Specify category in which the setting is under. Support $filters.|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information.| |id|String|Identifier for item| |description|String|Description of the setting.| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupcollectiondefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupcollectiondefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupcollectiondefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupcollectiondefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupcollectiondefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupcollectiondefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupcollectiondefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupcollectiondefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupcollectiondefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupcollectiondefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupdefinition Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupdefinition-create.md | One of the following permissions is required to call this API. To learn more, in --> ``` http POST /deviceManagement/reusableSettings+POST /deviceManagement/inventorySettings POST /deviceManagement/complianceSettings POST /deviceManagement/configurationSettings POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions The following table shows the properties that are required when you create the d |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupdefinition Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupdefinition-delete.md | One of the following permissions is required to call this API. To learn more, in --> ``` http DELETE /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+DELETE /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} DELETE /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupdefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupdefinition-get.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupdefinition List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupdefinition-list.md | One of the following permissions is required to call this API. To learn more, in --> ``` http GET /deviceManagement/reusableSettings+GET /deviceManagement/inventorySettings GET /deviceManagement/complianceSettings GET /deviceManagement/configurationSettings GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions |
v1.0 | Intune Deviceconfigv2 Devicemanagementconfigurationsettinggroupdefinition Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementconfigurationsettinggroupdefinition-update.md | One of the following permissions is required to call this API. To learn more, in --> ``` http PATCH /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}+PATCH /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId} PATCH /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId} The following table shows the properties that are required when you create the [ |offsetUri|String|Offset CSP Path from Base Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |rootDefinitionId|String|Root setting definition id if the setting is a child setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |categoryId|String|Specify category in which the setting is under. Support $filters. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)|-|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`.| +|settingUsage|[deviceManagementConfigurationSettingUsage](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingusage.md)|Indicate setting type for the setting. Possible values are: configuration, compliance, reusableSetting. Each setting usage has separate API end-point to call. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `configuration`, `compliance`, `unknownFutureValue`, `inventory`.| |uxBehavior|[deviceManagementConfigurationControlType](../resources/intune-deviceconfigv2-devicemanagementconfigurationcontroltype.md)|Setting control type representation in the UX. Possible values are: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `default`, `dropdown`, `smallTextBox`, `largeTextBox`, `toggle`, `multiheaderGrid`, `contextPane`, `unknownFutureValue`.|-|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`.| +|visibility|[deviceManagementConfigurationSettingVisibility](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingvisibility.md)|Setting visibility scope to UX. Possible values are: none, settingsCatalog, template. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md). Possible values are: `none`, `settingsCatalog`, `template`, `unknownFutureValue`, `inventoryCatalog`.| |referredSettingInformationList|[deviceManagementConfigurationReferredSettingInformation](../resources/intune-deviceconfigv2-devicemanagementconfigurationreferredsettinginformation.md) collection|List of referred setting information. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |id|String|Identifier for item Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |description|String|Description of the setting. Inherited from [deviceManagementConfigurationSettingDefinition](../resources/intune-deviceconfigv2-devicemanagementconfigurationsettingdefinition.md)| |
v1.0 | Intune Deviceconfigv2 Devicemanagementinventorypolicy Assign | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementinventorypolicy-assign.md | - Title: "assign action" -description: "Intune Deviceconfigv2 Devicemanagementinventorypolicy Assign Api ." ---doc_type: apiPageType ---# assign action --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assign -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply JSON representation of the parameters. --The following table shows the parameters that can be used with this action. --|Property|Type|Description| -|:|:|:| -|assignments|[deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection|| ----## Response -If successful, this action returns a `200 OK` response code and a [deviceManagementConfigurationPolicyAssignment](../resources/intune-deviceconfigv2-devicemanagementconfigurationpolicyassignment.md) collection in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId}/assign --Content-type: application/json -Content-length: 610 --{ - "assignments": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 604 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementConfigurationPolicyAssignment", - "id": "1f069921-9921-1f06-2199-061f2199061f", - "target": { - "@odata.type": "microsoft.graph.scopeTagGroupAssignmentTarget", - "deviceAndAppManagementAssignmentFilterId": "Device And App Management Assignment Filter Id value", - "deviceAndAppManagementAssignmentFilterType": "include", - "targetType": "user", - "entraObjectId": "Entra Object Id value" - }, - "source": "policySets", - "sourceId": "Source Id value" - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementinventorypolicy Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementinventorypolicy-create.md | - Title: "Create deviceManagementInventoryPolicy" -description: "Create a new deviceManagementInventoryPolicy object." ---doc_type: apiPageType ---# Create deviceManagementInventoryPolicy --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/inventoryPolicies -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceManagementInventoryPolicy object. --The following table shows the properties that are required when you create the deviceManagementInventoryPolicy. --|Property|Type|Description| -|:|:|:| -|id|String|Key of the policy document. Automatically generated.| -|name|String|Policy name| -|description|String|Policy description| -|platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| -|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| -|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| -|lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| -|settingCount|Int32|Number of settings. This property is read-only.| -|creationSource|String|Policy creation source| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance.| -|isAssigned|Boolean|Policy assignment status. This property is read-only.| -|version|Int32|Version of the Policy. Valid values 0 to 1000. This property is read-only.| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies -Content-type: application/json -Content-length: 361 --{ - "@odata.type": "#microsoft.graph.deviceManagementInventoryPolicy", - "name": "Name value", - "description": "Description value", - "platforms": "android", - "technologies": "mdm", - "settingCount": 12, - "creationSource": "Creation Source value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "isAssigned": true, - "version": 7 -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 533 --{ - "@odata.type": "#microsoft.graph.deviceManagementInventoryPolicy", - "id": "e1d940a2-40a2-e1d9-a240-d9e1a240d9e1", - "name": "Name value", - "description": "Description value", - "platforms": "android", - "technologies": "mdm", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "settingCount": 12, - "creationSource": "Creation Source value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "isAssigned": true, - "version": 7 -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementinventorypolicy Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementinventorypolicy-delete.md | - Title: "Delete deviceManagementInventoryPolicy" -description: "Deletes a deviceManagementInventoryPolicy." ---doc_type: apiPageType ---# Delete deviceManagementInventoryPolicy --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementinventorypolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementinventorypolicy-get.md | - Title: "Get deviceManagementInventoryPolicy" -description: "Read properties and relationships of the deviceManagementInventoryPolicy object." ---doc_type: apiPageType ---# Get deviceManagementInventoryPolicy --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 582 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceManagementInventoryPolicy", - "id": "e1d940a2-40a2-e1d9-a240-d9e1a240d9e1", - "name": "Name value", - "description": "Description value", - "platforms": "android", - "technologies": "mdm", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "settingCount": 12, - "creationSource": "Creation Source value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "isAssigned": true, - "version": 7 - } -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementinventorypolicy List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementinventorypolicy-list.md | - Title: "List deviceManagementInventoryPolicies" -description: "List properties and relationships of the deviceManagementInventoryPolicy objects." ---doc_type: apiPageType ---# List deviceManagementInventoryPolicies --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/inventoryPolicies -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 626 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceManagementInventoryPolicy", - "id": "e1d940a2-40a2-e1d9-a240-d9e1a240d9e1", - "name": "Name value", - "description": "Description value", - "platforms": "android", - "technologies": "mdm", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "settingCount": 12, - "creationSource": "Creation Source value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "isAssigned": true, - "version": 7 - } - ] -} -``` |
v1.0 | Intune Deviceconfigv2 Devicemanagementinventorypolicy Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-deviceconfigv2-devicemanagementinventorypolicy-update.md | - Title: "Update deviceManagementInventoryPolicy" -description: "Update the properties of a deviceManagementInventoryPolicy object." ---doc_type: apiPageType ---# Update deviceManagementInventoryPolicy --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) object. --The following table shows the properties that are required when you create the [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md). --|Property|Type|Description| -|:|:|:| -|id|String|Key of the policy document. Automatically generated.| -|name|String|Policy name| -|description|String|Policy description| -|platforms|[deviceManagementConfigurationPlatforms](../resources/intune-deviceconfigv2-devicemanagementconfigurationplatforms.md)|Platforms for this policy. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`.| -|technologies|[deviceManagementConfigurationTechnologies](../resources/intune-deviceconfigv2-devicemanagementconfigurationtechnologies.md)|Technologies for this policy. Possible values are: `none`, `mdm`, `windows10XManagement`, `configManager`, `appleRemoteManagement`, `microsoftSense`, `exchangeOnline`, `mobileApplicationManagement`, `linuxMdm`, `extensibility`, `enrollment`, `endpointPrivilegeManagement`, `unknownFutureValue`, `windowsOsRecovery`.| -|createdDateTime|DateTimeOffset|Policy creation date and time. This property is read-only.| -|lastModifiedDateTime|DateTimeOffset|Policy last modification date and time. This property is read-only.| -|settingCount|Int32|Number of settings. This property is read-only.| -|creationSource|String|Policy creation source| -|roleScopeTagIds|String collection|List of Scope Tags for this Entity instance.| -|isAssigned|Boolean|Policy assignment status. This property is read-only.| -|version|Int32|Version of the Policy. Valid values 0 to 1000. This property is read-only.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceManagementInventoryPolicy](../resources/intune-deviceconfigv2-devicemanagementinventorypolicy.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta/deviceManagement/inventoryPolicies/{deviceManagementInventoryPolicyId} -Content-type: application/json -Content-length: 361 --{ - "@odata.type": "#microsoft.graph.deviceManagementInventoryPolicy", - "name": "Name value", - "description": "Description value", - "platforms": "android", - "technologies": "mdm", - "settingCount": 12, - "creationSource": "Creation Source value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "isAssigned": true, - "version": 7 -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 533 --{ - "@odata.type": "#microsoft.graph.deviceManagementInventoryPolicy", - "id": "e1d940a2-40a2-e1d9-a240-d9e1a240d9e1", - "name": "Name value", - "description": "Description value", - "platforms": "android", - "technologies": "mdm", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "settingCount": 12, - "creationSource": "Creation Source value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ], - "isAssigned": true, - "version": 7 -} -``` |
v1.0 | Intune Devices Deviceinventory Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventory-create.md | - Title: "Create deviceInventory" -description: "Create a new deviceInventory object." ---doc_type: apiPageType ---# Create deviceInventory --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceInventory](../resources/intune-devices-deviceinventory.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceInventory object. --The following table shows the properties that are required when you create the deviceInventory. --|Property|Type|Description| -|:|:|:| -|id|String|The unique catalog id for this inventory entity type| -|displayName|String|The localized display name of the entity. Example: "Disk Drives". This property is read-only.| -|lastSyncDateTime|DateTimeOffset|The date and time that the inventory data was last synced with Intune. The value cannot be modified and is automatically populated when the device performs a sync. The Timestamp type represents date and time information and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only. This property is read-only.| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceInventory](../resources/intune-devices-deviceinventory.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories -Content-type: application/json -Content-length: 157 --{ - "@odata.type": "#microsoft.graph.deviceInventory", - "displayName": "Display Name value", - "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 206 --{ - "@odata.type": "#microsoft.graph.deviceInventory", - "id": "3c0a4e13-4e13-3c0a-134e-0a3c134e0a3c", - "displayName": "Display Name value", - "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" -} -``` |
v1.0 | Intune Devices Deviceinventory Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventory-delete.md | - Title: "Delete deviceInventory" -description: "Deletes a deviceInventory." ---doc_type: apiPageType ---# Delete deviceInventory --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceInventory](../resources/intune-devices-deviceinventory.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Devices Deviceinventory Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventory-get.md | - Title: "Get deviceInventory" -description: "Read properties and relationships of the deviceInventory object." ---doc_type: apiPageType ---# Get deviceInventory --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceInventory](../resources/intune-devices-deviceinventory.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceInventory](../resources/intune-devices-deviceinventory.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 233 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceInventory", - "id": "3c0a4e13-4e13-3c0a-134e-0a3c134e0a3c", - "displayName": "Display Name value", - "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" - } -} -``` |
v1.0 | Intune Devices Deviceinventory List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventory-list.md | - Title: "List deviceInventories" -description: "List properties and relationships of the deviceInventory objects." ---doc_type: apiPageType ---# List deviceInventories --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceInventory](../resources/intune-devices-deviceinventory.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceInventory](../resources/intune-devices-deviceinventory.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 255 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceInventory", - "id": "3c0a4e13-4e13-3c0a-134e-0a3c134e0a3c", - "displayName": "Display Name value", - "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventory Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventory-update.md | - Title: "Update deviceInventory" -description: "Update the properties of a deviceInventory object." ---doc_type: apiPageType ---# Update deviceInventory --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceInventory](../resources/intune-devices-deviceinventory.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceInventory](../resources/intune-devices-deviceinventory.md) object. --The following table shows the properties that are required when you create the [deviceInventory](../resources/intune-devices-deviceinventory.md). --|Property|Type|Description| -|:|:|:| -|id|String|The unique catalog id for this inventory entity type| -|displayName|String|The localized display name of the entity. Example: "Disk Drives". This property is read-only.| -|lastSyncDateTime|DateTimeOffset|The date and time that the inventory data was last synced with Intune. The value cannot be modified and is automatically populated when the device performs a sync. The Timestamp type represents date and time information and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'. Read-only. This property is read-only.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceInventory](../resources/intune-devices-deviceinventory.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId} -Content-type: application/json -Content-length: 157 --{ - "@odata.type": "#microsoft.graph.deviceInventory", - "displayName": "Display Name value", - "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 206 --{ - "@odata.type": "#microsoft.graph.deviceInventory", - "id": "3c0a4e13-4e13-3c0a-134e-0a3c134e0a3c", - "displayName": "Display Name value", - "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" -} -``` |
v1.0 | Intune Devices Deviceinventorycollectionproperty Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorycollectionproperty-create.md | - Title: "Create deviceInventoryCollectionProperty" -description: "Create a new deviceInventoryCollectionProperty object." ---doc_type: apiPageType ---# Create deviceInventoryCollectionProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST ** Collection URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceInventoryCollectionProperty object. --The following table shows the properties that are required when you create the deviceInventoryCollectionProperty. --|Property|Type|Description| -|:|:|:| -|id|String|The catalog id for this inventory property type Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|displayName|String|The localized display name of the property. Example: "Size (MB)". This property is read-only. Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|values|[deviceInventoryValue](../resources/intune-devices-deviceinventoryvalue.md) collection|Collection value of the property. This property is read-only.| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta** Collection URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -Content-type: application/json -Content-length: 272 --{ - "@odata.type": "#microsoft.graph.deviceInventoryCollectionProperty", - "displayName": "Display Name value", - "values": [ - { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 321 --{ - "@odata.type": "#microsoft.graph.deviceInventoryCollectionProperty", - "id": "407d83d8-83d8-407d-d883-7d40d8837d40", - "displayName": "Display Name value", - "values": [ - { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventorycollectionproperty Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorycollectionproperty-delete.md | - Title: "Delete deviceInventoryCollectionProperty" -description: "Deletes a deviceInventoryCollectionProperty." ---doc_type: apiPageType ---# Delete deviceInventoryCollectionProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE ** Entity URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Devices Deviceinventorycollectionproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorycollectionproperty-get.md | - Title: "Get deviceInventoryCollectionProperty" -description: "Read properties and relationships of the deviceInventoryCollectionProperty object." ---doc_type: apiPageType ---# Get deviceInventoryCollectionProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET ** Entity URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta** Entity URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 358 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceInventoryCollectionProperty", - "id": "407d83d8-83d8-407d-d883-7d40d8837d40", - "displayName": "Display Name value", - "values": [ - { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - ] - } -} -``` |
v1.0 | Intune Devices Deviceinventorycollectionproperty List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorycollectionproperty-list.md | - Title: "List deviceInventoryCollectionProperties" -description: "List properties and relationships of the deviceInventoryCollectionProperty objects." ---doc_type: apiPageType ---# List deviceInventoryCollectionProperties --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET ** Collection URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta** Collection URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 390 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceInventoryCollectionProperty", - "id": "407d83d8-83d8-407d-d883-7d40d8837d40", - "displayName": "Display Name value", - "values": [ - { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - ] - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventorycollectionproperty Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorycollectionproperty-update.md | - Title: "Update deviceInventoryCollectionProperty" -description: "Update the properties of a deviceInventoryCollectionProperty object." ---doc_type: apiPageType ---# Update deviceInventoryCollectionProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH ** Entity URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) object. --The following table shows the properties that are required when you create the [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md). --|Property|Type|Description| -|:|:|:| -|id|String|The catalog id for this inventory property type Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|displayName|String|The localized display name of the property. Example: "Size (MB)". This property is read-only. Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|values|[deviceInventoryValue](../resources/intune-devices-deviceinventoryvalue.md) collection|Collection value of the property. This property is read-only.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceInventoryCollectionProperty](../resources/intune-devices-deviceinventorycollectionproperty.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta** Entity URI for microsoft.management.services.api.deviceInventoryCollectionProperty not found -Content-type: application/json -Content-length: 272 --{ - "@odata.type": "#microsoft.graph.deviceInventoryCollectionProperty", - "displayName": "Display Name value", - "values": [ - { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 321 --{ - "@odata.type": "#microsoft.graph.deviceInventoryCollectionProperty", - "id": "407d83d8-83d8-407d-d883-7d40d8837d40", - "displayName": "Display Name value", - "values": [ - { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventoryitem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventoryitem-get.md | - Title: "Get deviceInventoryItem" -description: "Read properties and relationships of the deviceInventoryItem object." ---doc_type: apiPageType ---# Get deviceInventoryItem --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceInventoryItem](../resources/intune-devices-deviceinventoryitem.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceInventoryItem](../resources/intune-devices-deviceinventoryitem.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 133 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceInventoryItem", - "id": "60ac46c6-46c6-60ac-c646-ac60c646ac60" - } -} -``` |
v1.0 | Intune Devices Deviceinventoryitem List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventoryitem-list.md | - Title: "List deviceInventoryItems" -description: "List properties and relationships of the deviceInventoryItem objects." ---doc_type: apiPageType ---# List deviceInventoryItems --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceInventoryItem](../resources/intune-devices-deviceinventoryitem.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceInventoryItem](../resources/intune-devices-deviceinventoryitem.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 151 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceInventoryItem", - "id": "60ac46c6-46c6-60ac-c646-ac60c646ac60" - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventoryproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventoryproperty-get.md | - Title: "Get deviceInventoryProperty" -description: "Read properties and relationships of the deviceInventoryProperty object." ---doc_type: apiPageType ---# Get deviceInventoryProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET ** Entity URI for microsoft.management.services.api.deviceInventoryProperty not found -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta** Entity URI for microsoft.management.services.api.deviceInventoryProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 179 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceInventoryProperty", - "id": "8267a2c0-a2c0-8267-c0a2-6782c0a26782", - "displayName": "Display Name value" - } -} -``` |
v1.0 | Intune Devices Deviceinventoryproperty List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventoryproperty-list.md | - Title: "List deviceInventoryProperties" -description: "List properties and relationships of the deviceInventoryProperty objects." ---doc_type: apiPageType ---# List deviceInventoryProperties --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET ** Collection URI for microsoft.management.services.api.deviceInventoryProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta** Collection URI for microsoft.management.services.api.deviceInventoryProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 199 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceInventoryProperty", - "id": "8267a2c0-a2c0-8267-c0a2-6782c0a26782", - "displayName": "Display Name value" - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleitem Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleitem-create.md | - Title: "Create deviceInventorySimpleItem" -description: "Create a new deviceInventorySimpleItem object." ---doc_type: apiPageType ---# Create deviceInventorySimpleItem --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceInventorySimpleItem object. --The following table shows the properties that are required when you create the deviceInventorySimpleItem. --|Property|Type|Description| -|:|:|:| -|id|String|A unique identifier for the inventory data Inherited from [deviceInventoryItem](../resources/intune-devices-deviceinventoryitem.md)| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances -Content-type: application/json -Content-length: 67 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleItem" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 116 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleItem", - "id": "b70f94fc-94fc-b70f-fc94-0fb7fc940fb7" -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleitem Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleitem-delete.md | - Title: "Delete deviceInventorySimpleItem" -description: "Deletes a deviceInventorySimpleItem." ---doc_type: apiPageType ---# Delete deviceInventorySimpleItem --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Devices Deviceinventorysimpleitem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleitem-get.md | - Title: "Get deviceInventorySimpleItem" -description: "Read properties and relationships of the deviceInventorySimpleItem object." ---doc_type: apiPageType ---# Get deviceInventorySimpleItem --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 139 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceInventorySimpleItem", - "id": "b70f94fc-94fc-b70f-fc94-0fb7fc940fb7" - } -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleitem List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleitem-list.md | - Title: "List deviceInventorySimpleItems" -description: "List properties and relationships of the deviceInventorySimpleItem objects." ---doc_type: apiPageType ---# List deviceInventorySimpleItems --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 157 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceInventorySimpleItem", - "id": "b70f94fc-94fc-b70f-fc94-0fb7fc940fb7" - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleitem Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleitem-update.md | - Title: "Update deviceInventorySimpleItem" -description: "Update the properties of a deviceInventorySimpleItem object." ---doc_type: apiPageType ---# Update deviceInventorySimpleItem --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) object. --The following table shows the properties that are required when you create the [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md). --|Property|Type|Description| -|:|:|:| -|id|String|A unique identifier for the inventory data Inherited from [deviceInventoryItem](../resources/intune-devices-deviceinventoryitem.md)| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceInventorySimpleItem](../resources/intune-devices-deviceinventorysimpleitem.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceInventories/{deviceInventoryId}/instances/{deviceInventoryItemId} -Content-type: application/json -Content-length: 67 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleItem" -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 116 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleItem", - "id": "b70f94fc-94fc-b70f-fc94-0fb7fc940fb7" -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleproperty Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleproperty-create.md | - Title: "Create deviceInventorySimpleProperty" -description: "Create a new deviceInventorySimpleProperty object." ---doc_type: apiPageType ---# Create deviceInventorySimpleProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST ** Collection URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceInventorySimpleProperty object. --The following table shows the properties that are required when you create the deviceInventorySimpleProperty. --|Property|Type|Description| -|:|:|:| -|id|String|The catalog id for this inventory property type Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|displayName|String|The localized display name of the property. Example: "Size (MB)". This property is read-only. Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|value|[deviceInventoryValue](../resources/intune-devices-deviceinventoryvalue.md)|Value of the property. This property is read-only.| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta** Collection URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -Content-type: application/json -Content-length: 249 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleProperty", - "displayName": "Display Name value", - "value": { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 298 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleProperty", - "id": "13e13882-3882-13e1-8238-e1138238e113", - "displayName": "Display Name value", - "value": { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleproperty Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleproperty-delete.md | - Title: "Delete deviceInventorySimpleProperty" -description: "Deletes a deviceInventorySimpleProperty." ---doc_type: apiPageType ---# Delete deviceInventorySimpleProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE ** Entity URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Devices Deviceinventorysimpleproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleproperty-get.md | - Title: "Get deviceInventorySimpleProperty" -description: "Read properties and relationships of the deviceInventorySimpleProperty object." ---doc_type: apiPageType ---# Get deviceInventorySimpleProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET ** Entity URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta** Entity URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 331 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceInventorySimpleProperty", - "id": "13e13882-3882-13e1-8238-e1138238e113", - "displayName": "Display Name value", - "value": { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - } -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleproperty List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleproperty-list.md | - Title: "List deviceInventorySimpleProperties" -description: "List properties and relationships of the deviceInventorySimpleProperty objects." ---doc_type: apiPageType ---# List deviceInventorySimpleProperties --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET ** Collection URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta** Collection URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 359 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceInventorySimpleProperty", - "id": "13e13882-3882-13e1-8238-e1138238e113", - "displayName": "Display Name value", - "value": { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } - } - ] -} -``` |
v1.0 | Intune Devices Deviceinventorysimpleproperty Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-deviceinventorysimpleproperty-update.md | - Title: "Update deviceInventorySimpleProperty" -description: "Update the properties of a deviceInventorySimpleProperty object." ---doc_type: apiPageType ---# Update deviceInventorySimpleProperty --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH ** Entity URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) object. --The following table shows the properties that are required when you create the [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md). --|Property|Type|Description| -|:|:|:| -|id|String|The catalog id for this inventory property type Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|displayName|String|The localized display name of the property. Example: "Size (MB)". This property is read-only. Inherited from [deviceInventoryProperty](../resources/intune-devices-deviceinventoryproperty.md)| -|value|[deviceInventoryValue](../resources/intune-devices-deviceinventoryvalue.md)|Value of the property. This property is read-only.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceInventorySimpleProperty](../resources/intune-devices-deviceinventorysimpleproperty.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta** Entity URI for microsoft.management.services.api.deviceInventorySimpleProperty not found -Content-type: application/json -Content-length: 249 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleProperty", - "displayName": "Display Name value", - "value": { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 298 --{ - "@odata.type": "#microsoft.graph.deviceInventorySimpleProperty", - "id": "13e13882-3882-13e1-8238-e1138238e113", - "displayName": "Display Name value", - "value": { - "@odata.type": "microsoft.graph.deviceInventoryDateTimeValue", - "value": "2017-01-01T00:02:59.3325615-08:00" - } -} -``` |
v1.0 | Intune Devices Manageddevice Retrievedevicelogsdownloadurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-manageddevice-retrievedevicelogsdownloadurl.md | - Title: "retrieveDeviceLogsDownloadUrl function" -description: "Intune Devices Manageddevice Retrievedevicelogsdownloadurl Api ." ---doc_type: apiPageType ---# retrieveDeviceLogsDownloadUrl function --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. -----## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementManagedDevices.Read.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/managedDevices/{managedDeviceId}/retrieveDeviceLogsDownloadUrl -GET /deviceManagement/comanagedDevices/{managedDeviceId}/retrieveDeviceLogsDownloadUrl -GET /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice/retrieveDeviceLogsDownloadUrl -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/retrieveDeviceLogsDownloadUrl -GET /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice/retrieveDeviceLogsDownloadUrl -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}/retrieveDeviceLogsDownloadUrl -GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/retrieveDeviceLogsDownloadUrl -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request URL, provide the following query parameters with values. -The following table shows the parameters that can be used with this function. --|Property|Type|Description| -|:|:|:| -|requestId|String|| ----## Response -If successful, this function returns a `200 OK` response code and a String in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}/retrieveDeviceLogsDownloadUrl(requestId='parameterValue') -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 69 --{ - "value": "https://example.com/retrieveDeviceLogsDownloadUrl/" -} -``` |
v1.0 | Intune Devices Remoteactionaudit Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-create.md | The following table shows the properties that are required when you create the r |actionState|[actionState](../resources/intune-shared-actionstate.md)|Action state. Possible values are: `none`, `pending`, `canceled`, `active`, `done`, `failed`, `notSupported`.| |managedDeviceId|String|Action target.| |deviceActionDetails|[keyValuePair_2OfString_String](../resources/intune-devices-keyvaluepair_2ofstring_string.md) collection|DeviceAction details|-|deviceActionCategory|[actionCategory](../resources/intune-devices-actioncategory.md)|DeviceAction category. Possible values are: `single`, `bulk`.| +|deviceActionCategory|[deviceActionCategory](../resources/intune-devices-deviceactioncategory.md)|DeviceAction category. Possible values are: `single`, `bulk`.| |bulkDeviceActionId|String|BulkAction ID| |
v1.0 | Intune Devices Remoteactionaudit Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-remoteactionaudit-update.md | The following table shows the properties that are required when you create the [ |actionState|[actionState](../resources/intune-shared-actionstate.md)|Action state. Possible values are: `none`, `pending`, `canceled`, `active`, `done`, `failed`, `notSupported`.| |managedDeviceId|String|Action target.| |deviceActionDetails|[keyValuePair_2OfString_String](../resources/intune-devices-keyvaluepair_2ofstring_string.md) collection|DeviceAction details|-|deviceActionCategory|[actionCategory](../resources/intune-devices-actioncategory.md)|DeviceAction category. Possible values are: `single`, `bulk`.| +|deviceActionCategory|[deviceActionCategory](../resources/intune-devices-deviceactioncategory.md)|DeviceAction category. Possible values are: `single`, `bulk`.| |bulkDeviceActionId|String|BulkAction ID| |
v1.0 | Intune Devices User Getloggedonmanageddevices | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-devices-user-getloggedonmanageddevices.md | + + Title: "getLoggedOnManagedDevices function" +description: "Intune Devices User Getloggedonmanageddevices Source_Api ." ++ms.localizationpriority: medium ++++# getLoggedOnManagedDevices function ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. +++++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/getLoggedOnManagedDevices +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this function returns a `200 OK` response code and a [managedDevice](../resources/intune-devices-manageddevice.md) collection in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +GET https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/getLoggedOnManagedDevices +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 10964 ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.managedDevice", + "id": "705c034c-034c-705c-4c03-5c704c035c70", + "userId": "User Id value", + "deviceName": "Device Name value", + "hardwareInformation": { + "@odata.type": "microsoft.graph.hardwareInformation", + "serialNumber": "Serial Number value", + "totalStorageSpace": 1, + "freeStorageSpace": 0, + "imei": "Imei value", + "meid": "Meid value", + "manufacturer": "Manufacturer value", + "model": "Model value", + "phoneNumber": "Phone Number value", + "subscriberCarrier": "Subscriber Carrier value", + "cellularTechnology": "Cellular Technology value", + "wifiMac": "Wifi Mac value", + "operatingSystemLanguage": "Operating System Language value", + "isSupervised": true, + "isEncrypted": true, + "batterySerialNumber": "Battery Serial Number value", + "batteryHealthPercentage": 7, + "batteryChargeCycles": 3, + "isSharedDevice": true, + "sharedDeviceCachedUsers": [ + { + "@odata.type": "microsoft.graph.sharedAppleDeviceUser", + "userPrincipalName": "User Principal Name value", + "dataToSync": true, + "dataQuota": 9, + "dataUsed": 8 + } + ], + "tpmSpecificationVersion": "Tpm Specification Version value", + "operatingSystemEdition": "Operating System Edition value", + "deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value", + "deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired", + "deviceGuardVirtualizationBasedSecurityState": "rebootRequired", + "deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired", + "osBuildNumber": "Os Build Number value", + "operatingSystemProductType": 10, + "ipAddressV4": "Ip Address V4 value", + "subnetAddress": "Subnet Address value", + "esimIdentifier": "Esim Identifier value", + "systemManagementBIOSVersion": "System Management BIOSVersion value", + "tpmManufacturer": "Tpm Manufacturer value", + "tpmVersion": "Tpm Version value", + "wiredIPv4Addresses": [ + "Wired IPv4Addresses value" + ], + "batteryLevelPercentage": 7.333333333333333, + "residentUsersCount": 2, + "productName": "Product Name value", + "deviceLicensingStatus": "licenseRefreshPending", + "deviceLicensingLastErrorCode": 12, + "deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value" + }, + "ownerType": "company", + "managedDeviceOwnerType": "company", + "deviceActionResults": [ + { + "@odata.type": "microsoft.graph.deviceActionResult", + "actionName": "Action Name value", + "actionState": "pending", + "startDateTime": "2016-12-31T23:58:46.7156189-08:00", + "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00" + } + ], + "managementState": "retirePending", + "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00", + "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00", + "chassisType": "desktop", + "operatingSystem": "Operating System value", + "deviceType": "windowsRT", + "complianceState": "compliant", + "jailBroken": "Jail Broken value", + "managementAgent": "mdm", + "osVersion": "Os Version value", + "easActivated": true, + "easDeviceId": "Eas Device Id value", + "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00", + "aadRegistered": true, + "azureADRegistered": true, + "deviceEnrollmentType": "userEnrollment", + "lostModeState": "enabled", + "activationLockBypassCode": "Activation Lock Bypass Code value", + "emailAddress": "Email Address value", + "azureActiveDirectoryDeviceId": "Azure Active Directory Device Id value", + "azureADDeviceId": "Azure ADDevice Id value", + "deviceRegistrationState": "registered", + "deviceCategoryDisplayName": "Device Category Display Name value", + "isSupervised": true, + "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00", + "exchangeAccessState": "unknown", + "exchangeAccessStateReason": "unknown", + "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/", + "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value", + "isEncrypted": true, + "userPrincipalName": "User Principal Name value", + "enrolledByUserPrincipalName": "Enrolled By User Principal Name value", + "model": "Model value", + "manufacturer": "Manufacturer value", + "imei": "Imei value", + "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00", + "serialNumber": "Serial Number value", + "phoneNumber": "Phone Number value", + "androidSecurityPatchLevel": "Android Security Patch Level value", + "userDisplayName": "User Display Name value", + "configurationManagerClientEnabledFeatures": { + "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures", + "inventory": true, + "modernApps": true, + "resourceAccess": true, + "deviceConfiguration": true, + "compliancePolicy": true, + "windowsUpdateForBusiness": true, + "endpointProtection": true, + "officeApps": true + }, + "wiFiMacAddress": "Wi Fi Mac Address value", + "deviceHealthAttestationState": { + "@odata.type": "microsoft.graph.deviceHealthAttestationState", + "lastUpdateDateTime": "Last Update Date Time value", + "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/", + "deviceHealthAttestationStatus": "Device Health Attestation Status value", + "contentVersion": "Content Version value", + "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00", + "attestationIdentityKey": "Attestation Identity Key value", + "resetCount": 10, + "restartCount": 12, + "dataExcutionPolicy": "Data Excution Policy value", + "bitLockerStatus": "Bit Locker Status value", + "bootManagerVersion": "Boot Manager Version value", + "codeIntegrityCheckVersion": "Code Integrity Check Version value", + "secureBoot": "Secure Boot value", + "bootDebugging": "Boot Debugging value", + "operatingSystemKernelDebugging": "Operating System Kernel Debugging value", + "codeIntegrity": "Code Integrity value", + "testSigning": "Test Signing value", + "safeMode": "Safe Mode value", + "windowsPE": "Windows PE value", + "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value", + "virtualSecureMode": "Virtual Secure Mode value", + "pcrHashAlgorithm": "Pcr Hash Algorithm value", + "bootAppSecurityVersion": "Boot App Security Version value", + "bootManagerSecurityVersion": "Boot Manager Security Version value", + "tpmVersion": "Tpm Version value", + "pcr0": "Pcr0 value", + "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value", + "codeIntegrityPolicy": "Code Integrity Policy value", + "bootRevisionListInfo": "Boot Revision List Info value", + "operatingSystemRevListInfo": "Operating System Rev List Info value", + "healthStatusMismatchInfo": "Health Status Mismatch Info value", + "healthAttestationSupportedStatus": "Health Attestation Supported Status value", + "memoryIntegrityProtection": "enabled", + "memoryAccessProtection": "enabled", + "virtualizationBasedSecurity": "enabled", + "firmwareProtection": "systemGuardSecureLaunch", + "systemManagementMode": "level1", + "securedCorePC": "enabled" + }, + "subscriberCarrier": "Subscriber Carrier value", + "meid": "Meid value", + "totalStorageSpaceInBytes": 8, + "freeStorageSpaceInBytes": 7, + "managedDeviceName": "Managed Device Name value", + "partnerReportedThreatState": "activated", + "retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00", + "usersLoggedOn": [ + { + "@odata.type": "microsoft.graph.loggedOnUser", + "userId": "User Id value", + "lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00" + } + ], + "preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00", + "autopilotEnrolled": true, + "requireUserEnrollmentApproval": true, + "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00", + "iccid": "Iccid value", + "udid": "Udid value", + "roleScopeTagIds": [ + "Role Scope Tag Ids value" + ], + "windowsActiveMalwareCount": 9, + "windowsRemediatedMalwareCount": 13, + "notes": "Notes value", + "configurationManagerClientHealthState": { + "@odata.type": "microsoft.graph.configurationManagerClientHealthState", + "state": "installed", + "errorCode": 9, + "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" + }, + "configurationManagerClientInformation": { + "@odata.type": "microsoft.graph.configurationManagerClientInformation", + "clientIdentifier": "Client Identifier value", + "isBlocked": true, + "clientVersion": "Client Version value" + }, + "ethernetMacAddress": "Ethernet Mac Address value", + "physicalMemoryInBytes": 5, + "processorArchitecture": "x86", + "specificationVersion": "Specification Version value", + "joinType": "azureADJoined", + "skuFamily": "Sku Family value", + "securityPatchLevel": "Security Patch Level value", + "skuNumber": 9, + "managementFeatures": "microsoftManagedDesktop", + "chromeOSDeviceInfo": [ + { + "@odata.type": "microsoft.graph.chromeOSDeviceProperty", + "name": "Name value", + "value": "Value value", + "valueType": "Value Type value", + "updatable": true + } + ], + "supplementalDeviceDetails": [ + { + "@odata.type": "microsoft.graph.supplementalDeviceDetail", + "propertyName": "Property Name value", + "propertyValue": "Property Value value", + "propertyType": "Property Type value" + } + ], + "enrollmentProfileName": "Enrollment Profile Name value", + "bootstrapTokenEscrowed": true, + "deviceFirmwareConfigurationInterfaceManaged": true, + "deviceIdentityAttestationDetail": { + "@odata.type": "microsoft.graph.deviceIdentityAttestationDetail", + "deviceIdentityAttestationStatus": "trusted" + } + } + ] +} +``` |
v1.0 | Intune Grouppolicy Devicemanagementreports Getgrouppolicysettingsdevicesettingsreport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-grouppolicy-devicemanagementreports-getgrouppolicysettingsdevicesettingsreport.md | The following table shows the parameters that can be used with this action. |top|Int32|| |sessionId|String|| |filter|String||+|skiptoken|String|| Here is an example of the request. POST https://graph.microsoft.com/beta/deviceManagement/reports/getGroupPolicySettingsDeviceSettingsReport Content-type: application/json-Content-length: 278 +Content-length: 313 { "name": "Name value", Content-length: 278 "skip": 4, "top": 3, "sessionId": "Session Id value",- "filter": "Filter value" + "filter": "Filter value", + "skiptoken": "Skiptoken value" } ``` |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelconfiguration-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelConfiguration](../resources/intune-mstunnel-microsofttunnelconfiguration.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelhealththreshold Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelhealththreshold-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelHealthThreshold](../resources/intune-mstunnel-microsofttunnelhealththreshold.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Createserverlogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-createserverlogcollectionrequest.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Generateserverlogcollectionrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-generateserverlogcollectionrequest.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Gethealthmetrics | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-gethealthmetrics.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Gethealthmetrictimeseries | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-gethealthmetrictimeseries.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserver Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserver-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelServer](../resources/intune-mstunnel-microsofttunnelserver.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Createdownloadurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-createdownloadurl.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Generatedownloadurl | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-generatedownloadurl.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelserverlogcollectionresponse Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelserverlogcollectionresponse-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelServerLogCollectionResponse](../resources/intune-mstunnel-microsofttunnelserverlogcollectionresponse.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-create.md | Namespace: microsoft.graph Create a new [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-delete.md | Namespace: microsoft.graph Deletes a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-get.md | Namespace: microsoft.graph Read properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-list.md | Namespace: microsoft.graph List properties and relationships of the [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Requestupgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-requestupgrade.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Mstunnel Microsofttunnelsite Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-mstunnel-microsofttunnelsite-update.md | Namespace: microsoft.graph Update the properties of a [microsoftTunnelSite](../resources/intune-mstunnel-microsofttunnelsite.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Multidevicepivotservice Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-multidevicepivotservice-devicemanagement-get.md | + + Title: "Get deviceManagement" +description: "Read properties and relationships of the deviceManagement object." ++ms.localizationpriority: medium ++++# Get deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Read properties and relationships of the [deviceManagement](../resources/intune-multidevicepivotservice-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /deviceManagement +``` ++## Optional query parameters +This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-multidevicepivotservice-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +GET https://graph.microsoft.com/beta/deviceManagement +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 79 ++{ + "value": { + "@odata.type": "#microsoft.graph.deviceManagement" + } +} +``` |
v1.0 | Intune Multidevicepivotservice Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-multidevicepivotservice-devicemanagement-update.md | + + Title: "Update deviceManagement" +description: "Update the properties of a deviceManagement object." ++ms.localizationpriority: medium ++++# Update deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Update the properties of a [deviceManagement](../resources/intune-multidevicepivotservice-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /deviceManagement +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-multidevicepivotservice-devicemanagement.md) object. ++The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-multidevicepivotservice-devicemanagement.md). ++|Property|Type|Description| +|:|:|:| ++++## Response +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-multidevicepivotservice-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +PATCH https://graph.microsoft.com/beta/deviceManagement +Content-type: application/json +Content-length: 58 ++{ + "@odata.type": "#microsoft.graph.deviceManagement" +} +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 58 ++{ + "@odata.type": "#microsoft.graph.deviceManagement" +} +``` |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-create.md | Namespace: microsoft.graph Create a new [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-delete.md | Namespace: microsoft.graph Deletes a [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-get.md | Namespace: microsoft.graph Read properties and relationships of the [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-list.md | Namespace: microsoft.graph List properties and relationships of the [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Odj Devicemanagementdomainjoinconnector Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-odj-devicemanagementdomainjoinconnector-update.md | Namespace: microsoft.graph Update the properties of a [deviceManagementDomainJoinConnector](../resources/intune-odj-devicemanagementdomainjoinconnector.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-create.md | Namespace: microsoft.graph Create a new [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-delete.md | Namespace: microsoft.graph Deletes a [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md). ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-get.md | Namespace: microsoft.graph Read properties and relationships of the [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Getallmanageddevicewindowsosimages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-getallmanageddevicewindowsosimages.md | Namespace: microsoft.graph ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-list.md | Namespace: microsoft.graph List properties and relationships of the [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) objects. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Osprovisioninggraphservice Manageddevicewindowsoperatingsystemimage Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage-update.md | Namespace: microsoft.graph Update the properties of a [managedDeviceWindowsOperatingSystemImage](../resources/intune-osprovisioninggraphservice-manageddevicewindowsoperatingsystemimage.md) object. ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-create.md | Content-Length: 269 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-delete.md | DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.se Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-get.md | Content-Length: 298 "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" } }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-list.md | Content-Length: 322 } ] }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymanageddevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymanageddevice-update.md | Content-Length: 269 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-create.md | Content-Length: 396 "mobileAppType": "Mobile App Type value", "version": "Version value" }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-delete.md | DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.se Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-get.md | Content-Length: 431 "version": "Version value" } }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-list.md | Content-Length: 461 } ] }-``` +``` |
v1.0 | Intune Partnerintegration Appvulnerabilitymobileapp Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-appvulnerabilitymobileapp-update.md | Content-Length: 396 "mobileAppType": "Mobile App Type value", "version": "Version value" }-``` +``` |
v1.0 | Intune Partnerintegration Configmanagercollection Getpolicysummary | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-configmanagercollection-getpolicysummary.md | Content-Length: 276 "enforcedDeviceCount": 3 } }-``` +``` |
v1.0 | Intune Partnerintegration Devicemanagement Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-devicemanagement-get.md | + + Title: "Get deviceManagement" +description: "Read properties and relationships of the deviceManagement object." ++ms.localizationpriority: medium ++++# Get deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Read properties and relationships of the [deviceManagement](../resources/intune-partnerintegration-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +GET /deviceManagement +``` ++## Optional query parameters +This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +Do not supply a request body for this method. ++## Response +If successful, this method returns a `200 OK` response code and [deviceManagement](../resources/intune-partnerintegration-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +GET https://graph.microsoft.com/beta/deviceManagement +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 301 ++{ + "value": { + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "0b283420-3420-0b28-2034-280b2034280b", + "organizationalMessageFeatureOnboarding": { + "@odata.type": "microsoft.graph.organizationalMessageFeatureOnboarding", + "hasRequiredLicense": true + } + } +} +``` |
v1.0 | Intune Partnerintegration Devicemanagement Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-devicemanagement-update.md | + + Title: "Update deviceManagement" +description: "Update the properties of a deviceManagement object." ++ms.localizationpriority: medium ++++# Update deviceManagement ++Namespace: microsoft.graph ++> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. ++> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. ++Update the properties of a [deviceManagement](../resources/intune-partnerintegration-devicemanagement.md) object. +++## Permissions +One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). ++|Permission type|Permissions (from least to most privileged)| +|:|:| +|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.| +|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All| ++## HTTP Request +<!-- { + "blockType": "ignored" +} +--> +``` http +PATCH /deviceManagement +``` ++## Request headers +|Header|Value| +|:|:| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +|Accept|application/json| ++## Request body +In the request body, supply a JSON representation for the [deviceManagement](../resources/intune-partnerintegration-devicemanagement.md) object. ++The following table shows the properties that are required when you create the [deviceManagement](../resources/intune-partnerintegration-devicemanagement.md). ++|Property|Type|Description| +|:|:|:| +|id|String|Key of the entity.| +|organizationalMessageFeatureOnboarding|[organizationalMessageFeatureOnboarding](../resources/intune-partnerintegration-organizationalmessagefeatureonboarding.md)|OrganizationalMessageFeatureOnboarding| ++++## Response +If successful, this method returns a `200 OK` response code and an updated [deviceManagement](../resources/intune-partnerintegration-devicemanagement.md) object in the response body. ++## Example ++### Request +Here is an example of the request. +``` http +PATCH https://graph.microsoft.com/beta/deviceManagement +Content-type: application/json +Content-length: 221 ++{ + "@odata.type": "#microsoft.graph.deviceManagement", + "organizationalMessageFeatureOnboarding": { + "@odata.type": "microsoft.graph.organizationalMessageFeatureOnboarding", + "hasRequiredLicense": true + } +} +``` ++### Response +Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. +``` http +HTTP/1.1 200 OK +Content-Type: application/json +Content-Length: 270 ++{ + "@odata.type": "#microsoft.graph.deviceManagement", + "id": "0b283420-3420-0b28-2034-280b2034280b", + "organizationalMessageFeatureOnboarding": { + "@odata.type": "microsoft.graph.organizationalMessageFeatureOnboarding", + "hasRequiredLicense": true + } +} +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-create.md | Content-Length: 263 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-delete.md | DELETE https://graph.microsoft.com/beta** Entity URI for microsoft.management.se Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. ``` http HTTP/1.1 204 No Content-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-get.md | Content-Length: 292 "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" } }-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-list.md | Content-Length: 316 } ] }-``` +``` |
v1.0 | Intune Partnerintegration Vulnerablemanageddevice Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-partnerintegration-vulnerablemanageddevice-update.md | Content-Length: 263 "displayName": "Display Name value", "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00" }-``` +``` |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Create | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-create.md | - Title: "Create deviceConfigurationProfile" -description: "Create a new deviceConfigurationProfile object." ---doc_type: apiPageType ---# Create deviceConfigurationProfile --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Create a new [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -POST /deviceManagement/deviceConfigurationProfiles -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the deviceConfigurationProfile object. --The following table shows the properties that are required when you create the deviceConfigurationProfile. --|Property|Type|Description| -|:|:|:| -|id|String|Profile Id of the object.| -|accountId|String|Account Id.| -|lastModifiedDateTime|DateTimeOffset|The date and time the entity was last modified.| -|createdDateTime|DateTimeOffset|The date and time the object was created.| -|profileName|String|Profile name| -|profileType|[profileType](../resources/intune-policylistingservice-profiletype.md)|Profile Type. Possible values are: `settingsCatalog`, `administrativeTemplates`, `importedADMXTemplates`, `oemAppConfig`, `hardwareConfig`, `dcV1EndpointProtection`, `dcV1DeviceRestrictions`.| -|platformType|[platformType](../resources/intune-policylistingservice-platformtype.md)|Platform Type. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`, `androidEnterprise`, `aosp`.| -|configurationTechnologies|Int32|Configuration Technologies for Settins Catalog Policies| -|templateId|String|TemplateId for Settings Catalog Policies| -|roleScopeTagIds|String collection|The list of scope tags for the configuration.| ----## Response -If successful, this method returns a `201 Created` response code and a [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -POST https://graph.microsoft.com/beta/deviceManagement/deviceConfigurationProfiles -Content-type: application/json -Content-length: 354 --{ - "@odata.type": "#microsoft.graph.deviceConfigurationProfile", - "accountId": "Account Id value", - "profileName": "Profile Name value", - "profileType": "administrativeTemplates", - "platformType": "android", - "configurationTechnologies": 9, - "templateId": "Template Id value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 201 Created -Content-Type: application/json -Content-Length: 526 --{ - "@odata.type": "#microsoft.graph.deviceConfigurationProfile", - "id": "1662ad38-ad38-1662-38ad-621638ad6216", - "accountId": "Account Id value", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "profileName": "Profile Name value", - "profileType": "administrativeTemplates", - "platformType": "android", - "configurationTechnologies": 9, - "templateId": "Template Id value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-delete.md | - Title: "Delete deviceConfigurationProfile" -description: "Deletes a deviceConfigurationProfile." ---doc_type: apiPageType ---# Delete deviceConfigurationProfile --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Deletes a [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md). ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -DELETE /deviceManagement/deviceConfigurationProfiles/{deviceConfigurationProfileId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `204 No Content` response code. --## Example --### Request -Here is an example of the request. -``` http -DELETE https://graph.microsoft.com/beta/deviceManagement/deviceConfigurationProfiles/{deviceConfigurationProfileId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 204 No Content -``` |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-get.md | - Title: "Get deviceConfigurationProfile" -description: "Read properties and relationships of the deviceConfigurationProfile object." ---doc_type: apiPageType ---# Get deviceConfigurationProfile --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Read properties and relationships of the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceConfigurationProfiles/{deviceConfigurationProfileId} -``` --## Optional query parameters -This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response. --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceConfigurationProfiles/{deviceConfigurationProfileId} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 571 --{ - "value": { - "@odata.type": "#microsoft.graph.deviceConfigurationProfile", - "id": "1662ad38-ad38-1662-38ad-621638ad6216", - "accountId": "Account Id value", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "profileName": "Profile Name value", - "profileType": "administrativeTemplates", - "platformType": "android", - "configurationTechnologies": 9, - "templateId": "Template Id value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] - } -} -``` |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-list.md | - Title: "List deviceConfigurationProfiles" -description: "List properties and relationships of the deviceConfigurationProfile objects." ---doc_type: apiPageType ---# List deviceConfigurationProfiles --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --List properties and relationships of the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) objects. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -GET /deviceManagement/deviceConfigurationProfiles -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -Do not supply a request body for this method. --## Response -If successful, this method returns a `200 OK` response code and a collection of [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) objects in the response body. --## Example --### Request -Here is an example of the request. -``` http -GET https://graph.microsoft.com/beta/deviceManagement/deviceConfigurationProfiles -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 611 --{ - "value": [ - { - "@odata.type": "#microsoft.graph.deviceConfigurationProfile", - "id": "1662ad38-ad38-1662-38ad-621638ad6216", - "accountId": "Account Id value", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "profileName": "Profile Name value", - "profileType": "administrativeTemplates", - "platformType": "android", - "configurationTechnologies": 9, - "templateId": "Template Id value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] - } - ] -} -``` |
v1.0 | Intune Policylistingservice Deviceconfigurationprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-policylistingservice-deviceconfigurationprofile-update.md | - Title: "Update deviceConfigurationProfile" -description: "Update the properties of a deviceConfigurationProfile object." ---doc_type: apiPageType ---# Update deviceConfigurationProfile --Namespace: microsoft.graph --> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported. --> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant. --Update the properties of a [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. ---## Permissions -One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from least to most privileged)| -|:|:| -|Delegated (work or school account)|DeviceManagementConfiguration.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.| -|Application|DeviceManagementConfiguration.ReadWrite.All| --## HTTP Request -<!-- { - "blockType": "ignored" -} >-``` http -PATCH /deviceManagement/deviceConfigurationProfiles/{deviceConfigurationProfileId} -``` --## Request headers -|Header|Value| -|:|:| -|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| -|Accept|application/json| --## Request body -In the request body, supply a JSON representation for the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object. --The following table shows the properties that are required when you create the [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md). --|Property|Type|Description| -|:|:|:| -|id|String|Profile Id of the object.| -|accountId|String|Account Id.| -|lastModifiedDateTime|DateTimeOffset|The date and time the entity was last modified.| -|createdDateTime|DateTimeOffset|The date and time the object was created.| -|profileName|String|Profile name| -|profileType|[profileType](../resources/intune-policylistingservice-profiletype.md)|Profile Type. Possible values are: `settingsCatalog`, `administrativeTemplates`, `importedADMXTemplates`, `oemAppConfig`, `hardwareConfig`, `dcV1EndpointProtection`, `dcV1DeviceRestrictions`.| -|platformType|[platformType](../resources/intune-policylistingservice-platformtype.md)|Platform Type. Possible values are: `none`, `android`, `iOS`, `macOS`, `windows10X`, `windows10`, `linux`, `unknownFutureValue`, `androidEnterprise`, `aosp`.| -|configurationTechnologies|Int32|Configuration Technologies for Settins Catalog Policies| -|templateId|String|TemplateId for Settings Catalog Policies| -|roleScopeTagIds|String collection|The list of scope tags for the configuration.| ----## Response -If successful, this method returns a `200 OK` response code and an updated [deviceConfigurationProfile](../resources/intune-policylistingservice-deviceconfigurationprofile.md) object in the response body. --## Example --### Request -Here is an example of the request. -``` http -PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurationProfiles/{deviceConfigurationProfileId} -Content-type: application/json -Content-length: 354 --{ - "@odata.type": "#microsoft.graph.deviceConfigurationProfile", - "accountId": "Account Id value", - "profileName": "Profile Name value", - "profileType": "administrativeTemplates", - "platformType": "android", - "configurationTechnologies": 9, - "templateId": "Template Id value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` --### Response -Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call. -``` http -HTTP/1.1 200 OK -Content-Type: application/json -Content-Length: 526 --{ - "@odata.type": "#microsoft.graph.deviceConfigurationProfile", - "id": "1662ad38-ad38-1662-38ad-621638ad6216", - "accountId": "Account Id value", - "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00", - "createdDateTime": "2017-01-01T00:02:43.5775965-08:00", - "profileName": "Profile Name value", - "profileType": "administrativeTemplates", - "platformType": "android", - "configurationTechnologies": 9, - "templateId": "Template Id value", - "roleScopeTagIds": [ - "Role Scope Tag Ids value" - ] -} -``` |
v1.0 | Intune Reporting Devicemanagementreports Getcachedreport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreports-getcachedreport.md | The following table shows the parameters that can be used with this action. |:|:|:| |id|String|| |select|String collection||-|search|String|| |groupBy|String collection|| |orderBy|String collection||+|search|String|| |skip|Int32|| |top|Int32|| Content-length: 209 "select": [ "Select value" ],- "search": "Search value", "groupBy": [ "Group By value" ], "orderBy": [ "Order By value" ],+ "search": "Search value", "skip": 4, "top": 3 } |
v1.0 | Intune Reporting Devicemanagementreports Getcompliancepolicynoncompliancereport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreports-getcompliancepolicynoncompliancereport.md | The following table shows the parameters that can be used with this action. |:|:|:| |name|String|| |select|String collection||-|search|String|| |groupBy|String collection|| |orderBy|String collection||+|search|String|| |skip|Int32|| |top|Int32|| |sessionId|String|| Content-length: 278 "select": [ "Select value" ],- "search": "Search value", "groupBy": [ "Group By value" ], "orderBy": [ "Order By value" ],+ "search": "Search value", "skip": 4, "top": 3, "sessionId": "Session Id value", |
v1.0 | Intune Reporting Devicemanagementreports Getcompliancepolicynoncompliancesummaryreport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreports-getcompliancepolicynoncompliancesummaryreport.md | The following table shows the parameters that can be used with this action. |:|:|:| |name|String|| |select|String collection||-|search|String|| |groupBy|String collection|| |orderBy|String collection||+|search|String|| |skip|Int32|| |top|Int32|| |sessionId|String|| Content-length: 278 "select": [ "Select value" ],- "search": "Search value", "groupBy": [ "Group By value" ], "orderBy": [ "Order By value" ],+ "search": "Search value", "skip": 4, "top": 3, "sessionId": "Session Id value", |
v1.0 | Intune Reporting Devicemanagementreports Getcompliancesettingnoncompliancereport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreports-getcompliancesettingnoncompliancereport.md | The following table shows the parameters that can be used with this action. |:|:|:| |name|String|| |select|String collection||-|search|String|| |groupBy|String collection|| |orderBy|String collection||+|search|String|| |skip|Int32|| |top|Int32|| |sessionId|String|| Content-length: 278 "select": [ "Select value" ],- "search": "Search value", "groupBy": [ "Group By value" ], "orderBy": [ "Order By value" ],+ "search": "Search value", "skip": 4, "top": 3, "sessionId": "Session Id value", |
v1.0 | Intune Reporting Devicemanagementreports Getconfigurationpolicynoncompliancereport | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/intune-reporting-devicemanagementreports-getconfigurationpolicynoncompliancereport.md | The following table shows the parameters that can be used with this action. |:|:|:| |name|String|| |select|String collection||-|search|String|| |groupBy|String collection|| |orderBy|String collection||+|search|String|| |skip|Int32|| |top|Int32|| |sessionId|String|| Content-length: 278 "select": [ "Select value" ],- "search": "Search value", "groupBy": [ "Group By value" ], "orderBy": [ "Order By value" ],+ "search": "Search value", "skip": 4, "top": 3, "sessionId": "Session Id value", |