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 | 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 | 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) <!-- { The following example shows a 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) GET https://graph.microsoft.com/beta/applications/{id}/owners -##### 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 |
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 | Approvalitem Cancel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-cancel.md | Cancel the [approval item](../resources/approvalitem.md). The owner of the appro 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 |
v1.0 | Approvalitem Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-get.md | Read the properties and relationships of an [approvalItem](../resources/approval 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 |
v1.0 | Approvalitem List Requests | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-list-requests.md | Get a list of [approvalItemRequest](../resources/approvalitemrequest.md) objects 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 |
v1.0 | Approvalitem List Responses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-list-responses.md | Get a list of [approvalItemResponse](../resources/approvalitemresponse.md) objec 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 |
v1.0 | Approvalitem Post Responses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitem-post-responses.md | Create a new [approvalItemResponse](../resources/approvalitemresponse.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": "approvalitem-post-responses-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalitem_post_responses" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalitem-post-responses-permissions.md)] ## HTTP request |
v1.0 | Approvalitemrequest Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitemrequest-get.md | Read the properties and relationships of an [approvalItemRequest](../resources/a 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 |
v1.0 | Approvalitemresponse Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalitemresponse-get.md | Read the properties and relationships of an [approvalItemResponse](../resources/ 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 |
v1.0 | Approvaloperation Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvaloperation-get.md | Read the properties and relationships of an [approvalOperation](../resources/app 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 |
v1.0 | Approvalsolution Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-get.md | Read the properties of an [approvalSolution](../resources/approvalsolution.md) o 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 |
v1.0 | Approvalsolution List Approvalitems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-list-approvalitems.md | Get a list of the [approvalItem](../resources/approvalitem.md) objects and their 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 |
v1.0 | Approvalsolution Post Approvalitems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-post-approvalitems.md | Create a new [approvalItem](../resources/approvalitem.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": "approvalsolution-post-approvalitems-permissions" -} >+<!-- { "blockType": "permissions", "name": "approvalsolution_post_approvalitems" } --> [!INCLUDE [permissions-table](../includes/permissions/approvalsolution-post-approvalitems-permissions.md)] ## HTTP request |
v1.0 | Approvalsolution Provision | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/approvalsolution-provision.md | Provision an [approvalSolution](../resources/approvalsolution.md) on behalf of a 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 |
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 | Backuprestoreroot Post Exchangerestoresessions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/backuprestoreroot-post-exchangerestoresessions.md | 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 | 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 | 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 |
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 | 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": { |
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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 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 | Networkaccess Branchconnectivityconfiguration Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchconnectivityconfiguration-get.md | GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch [!INCLUDE [sample-code](../includes/snippets/php/get-branchconnectivityconfiguration-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-branchconnectivityconfiguration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite Delete Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-delete-devicelinks.md | DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{bra [!INCLUDE [sample-code](../includes/snippets/php/delete-devicelink-deprecated-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/delete-devicelink-deprecated-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-delete.md | DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{bra [!INCLUDE [sample-code](../includes/snippets/php/delete-branchsite-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/delete-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-get.md | GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch [!INCLUDE [sample-code](../includes/snippets/php/get-branchsite-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-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite List Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-list-devicelinks.md | GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch [!INCLUDE [sample-code](../includes/snippets/php/list-devicelink-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/list-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite List Forwardingprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-list-forwardingprofiles.md | GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches/{branch [!INCLUDE [sample-code](../includes/snippets/php/list-forwardingprofiles-branchsite-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/list-forwardingprofiles-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite Post Devicelinks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-post-devicelinks.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-devicelink-from--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/create-devicelink-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Branchsite Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-branchsite-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-branchsite-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/update-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Conditionalaccesssettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-conditionalaccesssettings-get.md | GET https://graph.microsoft.com/beta/networkAccess/settings/conditionalAccess [!INCLUDE [sample-code](../includes/snippets/php/get-conditionalaccesssettings-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-conditionalaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Conditionalaccesssettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-conditionalaccesssettings-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-conditionalaccesssettings-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/update-conditionalaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Connectivity List Branches | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-list-branches.md | GET https://graph.microsoft.com/beta/networkAccess/connectivity/branches [!INCLUDE [sample-code](../includes/snippets/php/list-branchsite-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/list-branchsite-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Connectivity Post Branches | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-post-branches.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-branchsite-from--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/create-branchsite-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Connectivity Post Remotenetworks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-connectivity-post-remotenetworks.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-remotenetwork-basic-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/create-remotenetwork-basic-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-remotenetwork-with-forwardingprofile-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/create-remotenetwork-with-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-remotenetwork-with-forwardingprofile-devicelink-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/create-remotenetwork-with-forwardingprofile-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Crosstenantaccesssettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-crosstenantaccesssettings-get.md | GET https://graph.microsoft.com/beta/networkAccess/settings/crossTenantAccess [!INCLUDE [sample-code](../includes/snippets/php/get-crosstenantaccesssettings-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-crosstenantaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Crosstenantaccesssettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-crosstenantaccesssettings-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-crosstenantaccesssettings-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/update-crosstenantaccesssettings-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Devicelink Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-delete.md | DELETE https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetwork [!INCLUDE [sample-code](../includes/snippets/php/delete-devicelink-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/delete-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Devicelink Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-get.md | GET https://graph.microsoft.com/beta/networkAccess/connectivity/remoteNetworks/d [!INCLUDE [sample-code](../includes/snippets/php/get-devicelink-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-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Devicelink Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-devicelink-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-devicelink-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/update-devicelink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Enrichedauditlogs Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-enrichedauditlogs-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-enrichedauditlogs-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/update-enrichedauditlogs-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicy-get.md | GET https://graph.microsoft.com/beta/networkAccess/filteringPolicies/161760b2-70 [!INCLUDE [sample-code](../includes/snippets/php/get-filteringpolicy-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-filteringpolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringpolicy Post Policyrules | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicy-post-policyrules.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-policyrule-from--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/create-policyrule-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringpolicylink Delete Policy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-delete-policy.md | DELETE https://graph.microsoft.com/beta/networkaccess/filteringPolicies/d0187e08 [!INCLUDE [sample-code](../includes/snippets/php/delete-policy-from-filteringpolicylink-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/delete-policy-from-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringpolicylink Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-delete.md | DELETE https://graph.microsoft.com/beta/networkaccess/FilteringProfiles/c308a3af [!INCLUDE [sample-code](../includes/snippets/php/delete-filteringpolicylink-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/delete-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringpolicylink Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-get.md | GET https://graph.microsoft.com/beta/networkaccess/filteringPolicies/bb4e13cd-65 [!INCLUDE [sample-code](../includes/snippets/php/get-filteringpolicylink-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-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringpolicylink List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-list.md | GET https://graph.microsoft.com/beta/networkaccess/filteringProfiles/519085fd-ef [!INCLUDE [sample-code](../includes/snippets/php/list-filteringpolicylink-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/list-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringpolicylink Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringpolicylink-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-filteringpolicylink-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/update-filteringpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringprofile Delete Policies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-delete-policies.md | DELETE https://graph.microsoft.com/beta/networkaccess/FilteringProfiles/9020f79d [!INCLUDE [sample-code](../includes/snippets/php/delete-policylink-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/delete-policylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-get.md | GET https://graph.microsoft.com/beta/networkaccess/filteringProfiles/9020f79d-71 [!INCLUDE [sample-code](../includes/snippets/php/get-filteringprofile-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-filteringprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringprofile List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-list.md | GET https://graph.microsoft.com/beta/networkAccess/filteringProfiles [!INCLUDE [sample-code](../includes/snippets/php/list-filteringprofile-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/list-filteringprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringprofile-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-filteringprofile-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/update-filteringprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringrule Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-delete.md | DELETE https://graph.microsoft.com/beta/networkaccess/filteringPolicies/bb1d249e [!INCLUDE [sample-code](../includes/snippets/php/delete-filteringrule-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/delete-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringrule Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-get.md | GET https://graph.microsoft.com/beta/networkaccess/filteringPolicies/ac253559-37 [!INCLUDE [sample-code](../includes/snippets/php/get-filteringrule-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-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringrule List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-list.md | GET https://graph.microsoft.com/beta/networkaccess/filteringPolicies/d0187e08-04 [!INCLUDE [sample-code](../includes/snippets/php/list-filteringrule-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/list-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringrule Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-post.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-filteringrule-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/create-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Filteringrule Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-filteringrule-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-filteringrule-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/update-filteringrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingoptions Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingoptions-get.md | GET https://graph.microsoft.com/beta/networkAccess/settings/forwardingOptions [!INCLUDE [sample-code](../includes/snippets/php/get-forwardingoptions-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-forwardingoptions-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingoptions Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingoptions-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-forwardingoptions-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/update-forwardingoptions-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingpolicy Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicy-get.md | GET https://graph.microsoft.com/beta/networkAccess/forwardingPolicies/{forwardin [!INCLUDE [sample-code](../includes/snippets/php/get-forwardingpolicy-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-forwardingpolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingpolicylink Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicylink-delete.md | DELETE https://graph.microsoft.com/beta/networkaccess/forwardingProfiles/{forwar [!INCLUDE [sample-code](../includes/snippets/php/delete-forwardingpolicylink-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/delete-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingpolicylink Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicylink-get.md | GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles/{profileId [!INCLUDE [sample-code](../includes/snippets/php/get-forwardingpolicylink-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-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingpolicylink Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingpolicylink-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-forwardingpolicylink-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/update-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingprofile Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingprofile-get.md | GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles/{forwardin [!INCLUDE [sample-code](../includes/snippets/php/get-forwardingprofile-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-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingprofile List Policies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingprofile-list-policies.md | GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles/{forwardin [!INCLUDE [sample-code](../includes/snippets/php/list-forwardingpolicylink-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/list-forwardingpolicylink-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Forwardingprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-forwardingprofile-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-forwardingprofile-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/update-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Logs List Traffic | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-logs-list-traffic.md | GET https://graph.microsoft.com/beta/networkAccess/logs/traffic [!INCLUDE [sample-code](../includes/snippets/php/list-networkaccesstraffic-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/list-networkaccesstraffic-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Networkaccessroot List Filteringpolicies | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-networkaccessroot-list-filteringpolicies.md | GET https://graph.microsoft.com/beta/networkAccess/filteringPolicies [!INCLUDE [sample-code](../includes/snippets/php/list-filteringpolicy-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/list-filteringpolicy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Networkaccessroot List Forwardingprofiles | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-networkaccessroot-list-forwardingprofiles.md | GET https://graph.microsoft.com/beta/networkAccess/forwardingProfiles [!INCLUDE [sample-code](../includes/snippets/php/list-forwardingprofile-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/list-forwardingprofile-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Networkaccessroot Onboard | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-networkaccessroot-onboard.md | POST https://graph.microsoft.com/beta/networkAccess/microsoft.graph.networkacces [!INCLUDE [sample-code](../includes/snippets/php/create-tenantstatus-from--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/create-tenantstatus-from--python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Policy List Policyrules | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-policy-list-policyrules.md | GET https://graph.microsoft.com/beta/networkaccess/forwardingPolicies/{forwardin [!INCLUDE [sample-code](../includes/snippets/php/list-policyrule-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/list-policyrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Policylink List Policy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-policylink-list-policy.md | GET https://graph.microsoft.com/beta/networkaccess/filteringProfiles/78858adc-db [!INCLUDE [sample-code](../includes/snippets/php/list-policy-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/list-policy-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Policyrule Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-policyrule-get.md | GET https://graph.microsoft.com/beta/networkaccess/forwardingPolicies/{forwardin [!INCLUDE [sample-code](../includes/snippets/php/get-policyrule-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-policyrule-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Reports Entitiessummaries | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-reports-entitiessummaries.md | GET https://graph.microsoft.com/beta/networkAccess/reports/entitiesSummaries(sta [!INCLUDE [sample-code](../includes/snippets/php/reportsthisentitiessummaries-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/reportsthisentitiessummaries-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Settings List Enrichedauditlogs | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-settings-list-enrichedauditlogs.md | GET https://graph.microsoft.com/beta/networkaccess/settings/enrichedAuditLogs [!INCLUDE [sample-code](../includes/snippets/php/list-enrichedauditlogs-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/list-enrichedauditlogs-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Networkaccess Tenantstatus Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/networkaccess-tenantstatus-get.md | GET https://graph.microsoft.com/beta/networkAccess/tenantStatus [!INCLUDE [sample-code](../includes/snippets/php/get-tenantstatus-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-tenantstatus-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Notebook Getrecentnotebooks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/notebook-getrecentnotebooks.md | The `{id | userPrincipalName}` for the user must match the user encoded in the a ## 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 | Onattributecollectionexternalusersselfservicesignup Delete Attributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onattributecollectionexternalusersselfservicesignup-delete-attributes.md | Namespace: microsoft.graph Remove an attribute from an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow. -After this step, [PATCH the user flow](../api/authenticationeventsflow-update.md) to remove the attribute from the attribute collection step. +The attribute is removed from both the **attributes** and **views** collections of the **attributeCollectionPage** object in the user flow. ++This API operation fails when you attempt to remove the last remaining attribute on the user flow. ## 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). Don't supply a request body for this method. ## Response -If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details. +If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details. Attempting to remove the last remaining attribute results in a `400 Bad Request` error code. ## Examples #### Request-The following example shows a request that removes city as an attribute from the attribute collection step of an external identities self-service sign-up user flow. After executing this step, [update the attributes collected in the userflow](../api/authenticationeventsflow-update.md). +The following example shows a request that removes city as an attribute from the attribute collection step of an external identities self-service sign-up user flow. + # [HTTP](#tab/http) <!-- { "blockType": "request", |
v1.0 | Onattributecollectionexternalusersselfservicesignup Post Attributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onattributecollectionexternalusersselfservicesignup-post-attributes.md | Namespace: microsoft.graph Add an attribute to an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow. -Prior to this step, [PATCH the user flow](../api/authenticationeventsflow-update.md) to add the attribute to the attribute collection step (to determine how it will be displayed). +The attribute is added to both the **attributeCollection**> **attributes** and **attributeCollection**> **attributeCollectionPage** > **views** collections on the user flow. In the **views** collection, the attribute is assigned the default settings. You can [PATCH the user flow](../api/authenticationeventsflow-update.md) to customize the settings of the attribute on the **views** object, for example, marking it as required or updating the allowed input types. ## 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). If successful, this method returns a `204 No Content` response code. If unsucce #### Request -The following example shows a request that adds city as an attribute for attribute collection step of an external identities self-service sign-up user flow. Before you can add an attribute to the attribute collection step, you must first [add it among the attributes to be collected in the user flow](../api/authenticationeventsflow-update.md). +The following example shows a request that adds city as an attribute for attribute collection step of an external identities self-service sign-up user flow. If the request is successful, the attribute is added to both the **attributeCollection**> **attributes** and **attributeCollection**> **attributeCollectionPage** > **views** collections on the user flow. After adding the attribute to the user flow, you can [PATCH the user flow](../api/authenticationeventsflow-update.md) to customize the settings of the attribute on the **views** object, that is, customize the page layout. # [HTTP](#tab/http) <!-- { |
v1.0 | Onlinemeeting Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/onlinemeeting-update.md | Namespace: microsoft.graph Update the properties of the specified [onlineMeeting](../resources/onlinemeeting.md) object. -Please see [Request body](#request-body) section for the list of properties that support updating. +For the list of properties that support updating, see the [Request body](#request-body) section. [!INCLUDE [national-cloud-support](../../includes/global-only.md)] PATCH /users/{userId}/onlineMeetings/{meetingId} > [!NOTE] >-> - **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more details, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy). +> - **userId** is the object ID of a user in [Microsoft Entra admin center > user management page](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/UsersManagementMenuBlade). For more information, see [application access policy](/graph/cloud-communication-online-meeting-application-access-policy). > - `meetingId` is the **id** of an [onlineMeeting](../resources/onlinemeeting.md) object. ## Request headers PATCH /users/{userId}/onlineMeetings/{meetingId} ## Request body -The following table lists the properties that can be updated. In the request body, include only the properties that need updating, with the following exceptions: +The following table lists the properties that can be updated. In the request body, supply *only* the values for properties that should be updated, with the following exceptions: -- Updating the start or end date/time of an online meeting always requires both **startDateTime** and **endDateTime** properties in the request body.-- The **organizer** field of the **participants** property cannot be updated. The organizer of the meeting cannot be modified after the meeting is created.-- Updating the **attendees** field of the **participants** property, such as adding or removing an attendee to the meeting, always requires the full list of attendees in the request body.+- If you update the start or end date/time of an online meeting, you must always include both **startDateTime** and **endDateTime** properties in the request body. +- The **organizer** field of the **participants** property can't be updated. The organizer of the meeting can't be modified after the meeting is created. +- If you update the **attendees** field of the **participants** property, such as adding or removing an attendee to the meeting, you must always include the full list of attendees in the request body. -The last column indicates whether updating this property will take effect for an in-progress meeting. +The last column indicates whether updating this property takes effect for an in-progress meeting. | Property | Type | Description | Applies to in-progress meetings? |-|--||-|| -| startDateTime | DateTime | The meeting start time in UTC. | No | -| endDateTime | DateTime | The meeting end time in UTC. | No | -| subject | String | The subject of the online meeting. | No | -| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. Only attendees can be updated. | No | -| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. | Yes | -| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | Yes | -| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. | Yes | -| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | Yes | -| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. | Yes | -| allowMeetingChat | meetingChatMode | Specifies the mode of meeting chat. | Yes | -| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. | Yes | -| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. | No | +|--||-| | +| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | Yes | +| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. | Yes | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. | No | +| allowedPresenters | onlineMeetingPresenters | Specifies who can be a presenter in a meeting. | Yes | +| allowLiveShare | Boolean | Indicates whether live share is enabled for the meeting. | No | +| allowMeetingChat | meetingChatMode | Specifies the mode of meeting chat. | Yes | +| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. | No | +| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. | Yes | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. | No | +| endDateTime | DateTime | The meeting end time in UTC. | No | +| isEntryExitAnnounced | Boolean | Whether or not to announce when callers join or leave. | Yes | +| lobbyBypassSettings | [lobbyBypassSettings](../resources/lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | Yes | +| participants | [meetingParticipants](../resources/meetingparticipants.md) | The participants associated with the online meeting. Only attendees can be updated. | No | +| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. | No | +| startDateTime | DateTime | The meeting start time in UTC. | No | +| subject | String | The subject of the online meeting. | No | > [!NOTE] > |
v1.0 | Peopleadminsettings Delete Photoupdatesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/peopleadminsettings-delete-photoupdatesettings.md | Delete a [photoUpdateSettings](../resources/photoupdatesettings.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": "peopleadminsettings-delete-photoupdatesettings-permissions" -} >+<!-- { "blockType": "permissions", "name": "peopleadminsettings_delete_photoupdatesettings" } --> [!INCLUDE [permissions-table](../includes/permissions/peopleadminsettings-delete-photoupdatesettings-permissions.md)] ## HTTP request |
v1.0 | Peopleadminsettings List Photoupdatesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/peopleadminsettings-list-photoupdatesettings.md | Get a list of the [photoUpdateSettings](../resources/photoupdatesettings.md) obj 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": "peopleadminsettings-list-photoupdatesettings-permissions" -} >+<!-- { "blockType": "permissions", "name": "peopleadminsettings_list_photoupdatesettings" } --> ## HTTP request Content-Type: application/json } ] }-``` +``` |
v1.0 | Photoupdatesettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/photoupdatesettings-get.md | Read the properties and relationships of a [photoUpdateSettings](../resources/ph 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": "photoupdatesettings-get-permissions" -} >+<!-- { "blockType": "permissions", "name": "photoupdatesettings_get" } --> [!INCLUDE [permissions-table](../includes/permissions/photoupdatesettings-get-permissions.md)] ## HTTP request |
v1.0 | Photoupdatesettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/photoupdatesettings-update.md | Update the properties of a [photoUpdateSettings](../resources/photoupdatesetting 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": "photoupdatesettings-update-permissions" -} >+<!-- { "blockType": "permissions", "name": "photoupdatesettings_update" } --> [!INCLUDE [permissions-table](../includes/permissions/photoupdatesettings-update-permissions.md)] ## HTTP request |
v1.0 | Plannerplanconfiguration Delete Localizations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfiguration-delete-localizations.md | - Title: "Delete plannerPlanConfigurationLocalization" -description: "Delete a plannerPlanConfigurationLocalization object." ---doc_type: apiPageType ---# Delete plannerPlanConfigurationLocalization --Namespace: microsoft.graph ---Delete a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.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": "plannerplanconfiguration_delete_localizations" } --> --## HTTP request --<!-- { - "blockType": "ignored" -} >--For a specific localization based on a business scenario ID and a localization ID: --``` http -DELETE /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId} -``` --For a specific localization based on the unique name of a business scenario and a localization ID: --``` http -DELETE /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId} -``` --## 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 `204 No Content` response code. --## Examples --### Request --The following example shows a request. --# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "delete_plannerplanconfigurationlocalization", - "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"] -} >-``` http -DELETE https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us -``` --# [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 | Plannerplanconfiguration Post Localizations | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfiguration-post-localizations.md | - Title: "Create plannerPlanConfigurationLocalization" -description: "Create a new plannerPlanConfigurationLocalization object." ---doc_type: apiPageType ---# Create plannerPlanConfigurationLocalization --Namespace: microsoft.graph ---Create a new [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.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": "plannerplanconfiguration_post_localizations" } --> --## HTTP request --<!-- { - "blockType": "ignored" -} >--For a specific localization based on a business scenario ID: --``` http -POST /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations -``` --For a specific localization based on the unique name of a business scenario: --``` http -POST /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations -``` --## 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 [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object. --You can specify the following properties when you create a **plannerPlanConfigurationLocalization**. --|Property|Type|Description| -|:|:|:| -|buckets|[plannerPlanConfigurationBucketLocalization](../resources/plannerplanconfigurationbucketlocalization.md) collection|Localizations for buckets specified in the [plannerPlanConfiguration](../resources/plannerplanconfiguration.md). Required.| -|languageTag|String|The code for the language the localized data is intended for. Required.| -|planTitle|String|Localized title of the plan. Required.| --## Response --If successful, this method returns a `201 Created` response code and a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body. --## Examples --### Request --The following example shows a request. ---# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "create_plannerplanconfigurationlocalization_from_", - "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d"] -} >-``` http -POST https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization", - "languageTag": "en-us", - "planTitle": "Order Tracking", - "buckets": [ - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "deliveryBucket", - "name": "Deliveries" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "storePickupBucket", - "name": "Pickup" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "specialOrdersBucket", - "name": "Special Orders" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "returnProcessingBucket", - "name": "Customer Returns" - } - ] -} -``` --# [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. -<!-- { - "blockType": "response", - "truncated": true, - "@odata.type": "microsoft.graph.plannerPlanConfigurationLocalization" -} >-``` http -HTTP/1.1 201 Created -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization", - "id": "en-us", - "languageTag": "en-us", - "planTitle": "Order Tracking", - "buckets": [ - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "deliveryBucket", - "name": "Deliveries" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "storePickupBucket", - "name": "Pickup" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "specialOrdersBucket", - "name": "Special Orders" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "returnProcessingBucket", - "name": "Customer Returns" - } - ] -} -``` |
v1.0 | Plannerplanconfiguration Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfiguration-update.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object for a [businessScenario](../resources/businessscenario.md). +Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object and its [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection for a [businessScenario](../resources/businessscenario.md). [!INCLUDE [national-cloud-support](../../includes/global-only.md)] PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfig |Property|Type|Description| |:|:|:|-|defaultLanguage|String|The language that should be used for creating plans when no language has been specified. Required.| -|buckets|[plannerPlanConfigurationBucketDefinition](../resources/plannerplanconfigurationbucketdefinition.md) collection|Buckets that will be available in the plan. Required.| +|defaultLanguage|String|The language that should be used for creating plans when no language has been specified.| +|buckets|[plannerPlanConfigurationBucketDefinition](../resources/plannerplanconfigurationbucketdefinition.md) collection|Buckets available in the plan.| +|localizations|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Localized names for the plan configuration.| ## Response PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864 Content-Type: application/json {- "@odata.type": "#microsoft.graph.plannerPlanConfiguration", "defaultLanguage": "en-us", "buckets": [ { Content-Type: application/json { "externalBucketId": "returnProcessingBucket" }+ ], + "localizations": [ + { + "id": "en-us", + "languageTag": "en-us", + "planTitle": "Order Tracking", + "buckets": [ + { + "externalBucketId": "deliveryBucket", + "name": "Deliveries" + }, + { + "externalBucketId": "storePickupBucket", + "name": "Pickup" + }, + { + "externalBucketId": "specialOrdersBucket", + "name": "Special Orders" + }, + { + "externalBucketId": "returnProcessingBucket", + "name": "Customer Returns" + } + ] + }, + { + "id": "es-es", + "languageTag": "es-es", + "planTitle": "Seguimiento de pedidos", + "buckets": [ + { + "externalBucketId": "deliveryBucket", + "name": "Entregas" + }, + { + "externalBucketId": "storePickupBucket", + "name": "Recogida" + }, + { + "externalBucketId": "specialOrdersBucket", + "name": "Pedidos especiales" + }, + { + "externalBucketId": "specialOrdersBucket", + "name": "Devoluciones de clientes" + } + ] + } ] } ``` Content-Type: application/json { "externalBucketId": "returnProcessingBucket" }+ ], + "localizations": [ + { + "id": "en-us", + "languageTag": "en-us", + "planTitle": "Order Tracking", + "buckets": [ + { + "externalBucketId": "deliveryBucket", + "name": "Deliveries" + }, + { + "externalBucketId": "storePickupBucket", + "name": "Pickup" + }, + { + "externalBucketId": "specialOrdersBucket", + "name": "Special Orders" + }, + { + "externalBucketId": "returnProcessingBucket", + "name": "Customer Returns" + } + ] + }, + { + "id": "es-es", + "languageTag": "es-es", + "planTitle": "Seguimiento de pedidos", + "buckets": [ + { + "externalBucketId": "deliveryBucket", + "name": "Entregas" + }, + { + "externalBucketId": "storePickupBucket", + "name": "Recogida" + }, + { + "externalBucketId": "specialOrdersBucket", + "name": "Pedidos especiales" + }, + { + "externalBucketId": "specialOrdersBucket", + "name": "Devoluciones de clientes" + } + ] + } ] } ``` |
v1.0 | Plannerplanconfigurationlocalization Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfigurationlocalization-get.md | - Title: "Get plannerPlanConfigurationLocalization" -description: "Read the properties and relationships of a plannerPlanConfigurationLocalization object." ---doc_type: apiPageType ---# Get plannerPlanConfigurationLocalization --Namespace: microsoft.graph ---Read the properties and relationships of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.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": "plannerplanconfigurationlocalization_get" } --> --## HTTP request --<!-- { - "blockType": "ignored" -} >--For a specific localization based on a business scenario ID and a localization ID: --``` http -GET /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId} -``` --For a specific localization based on the unique name of a business scenario and a localization ID: --``` http -GET /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId} -``` --## Optional query parameters --This method supports some of the OData query parameters 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 [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body. --## Examples --### Request --The following example shows a request. --# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "get_plannerplanconfigurationlocalization", - "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"] -} >-``` http -GET https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us -``` --# [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. -<!-- { - "blockType": "response", - "truncated": true, - "@odata.type": "microsoft.graph.plannerPlanConfigurationLocalization" -} >-``` http -HTTP/1.1 200 OK -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization", - "id": "en-us", - "languageTag": "en-us", - "planTitle": "Order Tracking", - "buckets": [ - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "deliveryBucket", - "name": "Deliveries" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "storePickupBucket", - "name": "Pickup" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "specialOrdersBucket", - "name": "Special Orders" - }, - { - "@odata.type": "microsoft.graph.plannerPlanConfigurationBucketLocalization", - "externalBucketId": "returnProcessingBucket", - "name": "Customer Returns" - } - ] -} -``` |
v1.0 | Plannerplanconfigurationlocalization Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/plannerplanconfigurationlocalization-update.md | - Title: "Update plannerPlanConfigurationLocalization" -description: "Update the properties of a plannerPlanConfigurationLocalization object." ---doc_type: apiPageType ---# Update plannerPlanConfigurationLocalization --Namespace: microsoft.graph ---Update the properties of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.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": "plannerplanconfigurationlocalization_update" } --> --## HTTP request --<!-- { - "blockType": "ignored" -} >--For a specific localization based on a business scenario ID and a localization ID: --``` http -PATCH /solutions/businessScenarios/{businessScenarioId}/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId} -``` --For a specific localization based on the unique name of a business scenario and a localization ID: --``` http -PATCH /solutions/businessScenarios(uniqueName='{uniqueName}')/planner/planConfiguration/localizations/{plannerPlanConfigurationLocalizationId} -``` --## 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 ---|Property|Type|Description| -|:|:|:| -|buckets|[plannerPlanConfigurationBucketLocalization](../resources/plannerplanconfigurationbucketlocalization.md) collection|Localizations for buckets specified in the [plannerPlanConfiguration](../resources/plannerplanconfiguration.md). Optional.| -|planTitle|String|Localized title of the plan. Optional.| --## Response --If successful, this method returns a `200 OK` response code and an updated [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object in the response body. --## Examples --### Request --The following example shows a request. --# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "update_plannerplanconfigurationlocalization", - "sampleKeys": ["c5d514e6c6864911ac46c720affb6e4d", "en-us"] -} >-``` http -PATCH https://graph.microsoft.com/beta/solutions/businessScenarios/c5d514e6c6864911ac46c720affb6e4d/planner/planConfiguration/localizations/en-us -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization", - "planTitle": "Order Tracking", - "buckets": [ - { - "externalBucketId": "deliveryBucket", - "name": "Deliveries" - }, - { - "externalBucketId": "storePickupBucket", - "name": "Pickup" - }, - { - "externalBucketId": "specialOrdersBucket", - "name": "Special Orders" - }, - { - "externalBucketId": "returnProcessingBucket", - "name": "Customer Returns" - } - ] -} -``` --# [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. -<!-- { - "blockType": "response", - "truncated": true, - "@odata.type": "microsoft.graph.plannerPlanConfigurationLocalization" -} >-``` http -HTTP/1.1 200 OK -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.plannerPlanConfigurationLocalization", - "id": "en-us", - "languageTag": "en-us", - "planTitle": "Order Tracking", - "buckets": [ - { - "externalBucketId": "deliveryBucket", - "name": "Deliveries" - }, - { - "externalBucketId": "storePickupBucket", - "name": "Pickup" - }, - { - "externalBucketId": "specialOrdersBucket", - "name": "Special Orders" - }, - { - "externalBucketId": "returnProcessingBucket", - "name": "Customer Returns" - } - ] -} -``` |
v1.0 | Reflectcheckinresponse Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/reflectcheckinresponse-get.md | Read the properties and relationships of a [reflectCheckInResponse](../resources 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": "reflectcheckinresponse-get-permissions" -} >+<!-- { "blockType": "permissions", "name": "reflectcheckinresponse_get" } --> [!INCLUDE [permissions-table](../includes/permissions/reflectcheckinresponse-get-permissions.md)] ## HTTP request |
v1.0 | Restorepoint Search | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/restorepoint-search.md | Content-Type: application/json The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "restorepoint_search_artifactquery" 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 | Security Incident Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/security-incident-update.md | PATCH /security/incidents/{incidentId} |assignedTo|String|Owner of the incident, or null if no owner is assigned. Free editable text.| |classification|microsoft.graph.security.alertClassification|The specification for the incident. Possible values are: `unknown`, `falsePositive`, `truePositive`, `informationalExpectedActivity`, `unknownFutureValue`.| |customTags|String collection|Array of custom tags associated with an incident.|-|determination|microsoft.graph.security.alertDetermination|Specifies the determination of the incident. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedUser`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.| +|determination|microsoft.graph.security.alertDetermination|Specifies the determination of the incident. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedAccount`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.| |status|microsoft.graph.security.incidentStatus|The status of the incident. Possible values are: `active`, `resolved`, `redirected`, `unknownFutureValue`.| |summary|String|The overview of an attack. When applicable, the summary contains details of what occurred, impacted assets, and the type of attack.| |
v1.0 | Securityaction Cancelsecurityaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityaction-cancelsecurityaction.md | POST /security/securityActions/{id}/cancelSecurityAction | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Securityaction Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityaction-get.md | This method supports some of the OData query parameters to help customize the re | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Securityactions List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityactions-list.md | This method supports some of the OData query parameters to help customize the re | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Securityactions Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/securityactions-post.md | POST /security/securityActions | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Serviceprincipal List Owners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/serviceprincipal-list-owners.md | Title: "servicePrincipals: List owners" + Title: "List owners of a service principal" description: "Retrieve a list of owners of the servicePrincipal." ms.localizationpriority: high doc_type: apiPageType-# servicePrincipals: List owners +# List owners of a service principal Namespace: microsoft.graph Choose the permission or permissions marked as least privileged for this API. Us [!INCLUDE [limited-info](../../includes/limited-info.md)] -- ## HTTP request <!-- { "blockType": "ignored" } --> ```http GET /servicePrincipals/{id}/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 | The following example shows a request. "name": "serviceprincipal_get_owners" }--> ```msgraph-interactive-GET https://graph.microsoft.com/beta/servicePrincipals/{id}/owners +GET https://graph.microsoft.com/beta/serviceprincipals(appId='bbec3106-565f-4907-941e-96b4dbfef21c')/owners ``` # [C#](#tab/csharp) 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 servicePrincipals(appId=<key>)/owners?$select=deletedDateTime", + "value": [ + { + "@odata.type": "#microsoft.graph.user", + "id": "ce4770b3-70b2-4a38-a242-76631e9f7408", + "accountEnabled": null, + "city": null, + "createdDateTime": null, + "displayName": null, + "mail": null, + "mailNickname": null, + "otherMails": [], + "proxyAddresses": [], + "surname": null, + "userPrincipalName": null, + "userType": 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 | Sharepointrestoresession Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/sharepointrestoresession-update.md | The following example shows a request. To remove a **siteRestoreArtifact** from a site restore session, specify the @removed annotation in the request body for the respective restore point artifact together with the ID of the [siteRestoreArtifact](../resources/siterestoreartifact.md). -# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "sharepointrestoresession_update" Content-Type: application/json } ``` -# [C#](#tab/csharp) --# [CLI](#tab/cli) --# [Java](#tab/java) --# [JavaScript](#tab/javascript) --# [PHP](#tab/php) --# [PowerShell](#tab/powershell) --# [Python](#tab/python) --- ### Response The following example shows the response. |
v1.0 | Synchronization Serviceprincipal Put Synchronization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-serviceprincipal-put-synchronization.md | PUT /servicePrincipals/{id}/synchronization/secrets ## 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, provide a JSON object with the following parameters. |
v1.0 | Synchronization Synchronizationjob Validatecredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationjob-validatecredentials.md | POST /servicePrincipals/{id}/synchronization/jobs/{id}/validateCredentials ## 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, provide a JSON object with the following parameters. |
v1.0 | Synchronization Synchronizationschema Parseexpression | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/synchronization-synchronizationschema-parseexpression.md | POST /servicePrincipals/{id}/synchronization/templates/{id}/schema/parseExpressi ## 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, provide a JSON object with the following parameters. |
v1.0 | Teamsapp Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-delete.md | You can also use this API to remove a submitted app from the review process. 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). ->**Note:** Only global administrators can call this API. +> [!NOTE] +> - The Directory.ReadWrite.All permission is supported only for backward compatibility. We recommend that you update your solutions to use an alternative permission and avoid using this permissions going forward. +> - You can only use the AppCatalog.Submit permission to delete app definitions in review. +> - Only global administrators can call this API. ++Permissions for the following HTTP request: -<!-- { "blockType": "permissions", "name": "teamsapp_delete" } --> +<!-- { "blockType": "ignored" } --> +```http +DELETE /appCatalogs/teamsApps/{id} +``` ++<!-- { "blockType": "permissions", "name": "teamsapp_delete", ΓÇâΓÇâ"requestUrls" : ["DELETE /appCatalogs/teamsApps/{id}"] } --> [!INCLUDE [permissions-table](../includes/permissions/teamsapp-delete-permissions.md)] -> [!NOTE] -> - The Directory.ReadWrite.All permission is 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. -> - You can only use the AppCatalog.Submit permission to delete app definitions in review. +Permissions for the following HTTP request: ++<!-- { "blockType": "ignored" } --> +```http +DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId} +``` +<!-- { "blockType": "permissions", "name": "teamsapp_delete", ΓÇâΓÇâ"requestUrls" : ["DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}"] } --> ++|Permission type|Least privileged permissions|Higher privileged permissions| +|:|:|:| +|Delegated (work or school account)|AppCatalog.Submit|AppCatalog.ReadWrite.All| +|Delegated (personal Microsoft account)|Not supported.|Not supported.| +|Application|Not supported.|Not supported.| + ## HTTP request |
v1.0 | Teamsapp Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/teamsapp-publish.md | Each app in the app catalog must have a unique manifest ID. If successful, this method returns a `200 OK` response code and a [teamsApp](../resources/teamsapp.md) object. If the app manifest has any validation errors, the request returns an error response with details about the schema errors. +### Error response ++If you send a request to upload an app manifest that contains missing information or errors, you receive an error message that includes the inner error code `UnableToParseTeamsAppManifest`. The **details** property of the inner error contains the error code and the error message. The following table describes the error codes that you might encounter. ++<br> +<details><summary>Error response</summary> ++| Error code | Error message | Description | +| :- | - | - | +|`Serialization_FileNotValidJson`| The file couldn't be parsed as a JSON object.| The submitted file didn't comply with a valid JSON format. | +|`Serialization_FileMissing`| The file {0} couldn't be found in the app package.| The expected file is missing in the app package.| +|`Serialization_TrailingCommaInManifestJsonFile`| Manifest json file contains trailing comma.| The app manifest file contains a trailing comma.| +|`SchemaError_MultipleOf`| Integer {0} isn't a multiple of {1}.| The app manifest file failed the `multipleOf` validation of the schema. Here, {0} represents the integer value and {1} indicates the required multiple. | +|`SchemaError_Maximum`| Integer {0} exceeds maximum value of {1}.| The app manifest file failed the `maximum` validation of the schema. Here, {0} represents the value that exceeds the maximum limit and {1} represents the maximum limit. | +|`SchemaError_Minimum`| Integer {0} is less than minimum value of {1}.|The app manifest file failed the `minimum` validation of the schema. Here, {0} represents the value that exceeds the minimum limit and {1} represents the minimum limit.| +|`SchemaError_MaximumLength`| String {0} exceeds maximum length of {1}.| The app manifest file failed the `maximumLength` validation of the schema. Here, {0} represents the string that exceeds the maximum length and {1} represents the maximum length.| +|`SchemaError_MinimumLength`| String {0} is less than minimum length of {1}. | The app manifest file failed the `minimumLength` validation of the schema. Here, {0} represents the string that is less than the minimum length and {1} represents the minimum.| +|`SchemaError_Pattern`| String {0} doesn't match regex pattern "{1}". | The app manifest file failed the `pattern` validation of the schema. Here, {0} represents the value that doesn't match the pattern and {1} represents the expected pattern.| +|`SchemaError_ContentEncoding`| String {0} doesn't validate against content encoding {1}.| The app manifest file failed the `contentEncoding` validation of the schema. Here, {0} represents the string that doesn't match content encoding and {1} represents the expected content encoding.| +|`SchemaError_Format`| String {0} doesn't validate against format {1}.| The app manifest file failed the `format` validation of the schema. Here, {0} represents the string that isn't in the expected format and {1} represents the expected format.| +|`SchemaError_Type`| Value {0} isn't of the expected type {1}.| The app manifest file failed the `type` validation of the schema. Here, {0} represents the string that isn't in the expected type and {1} represents the expected type.| +|`SchemaError_AdditionalItems`| The schema doesn't allow additional items.| The app manifest file failed the `additionalItems` validation of the schema.| +|`SchemaError_MaximumItems`| Array item count {0} exceeds maximum count of {1}.| The app manifest file failed the `maximumItems` validation of the schema. Here, {0} represents the number of elements in the array and {1} represents the maximum allowed.| +|`SchemaError_MinimumItems`| Array item count {0} is less than minimum count of {1}.| The app manifest file failed the `minimumItems` validation of the schema. Here, {0} represents the number of elements in the array and {1} represents the minimum allowed.| +|`SchemaError_UniqueItems`| Array contains items that aren't unique.| The app manifest file failed the `uniqueItems` validation of the schema.| +|`SchemaError_MaximumProperties`| Object property count {0} exceeds maximum count of {1}.| The app manifest file failed the `maximumProperties` validation of the schema. Here, {0} represents the number of properties provided and {1} represents the maximum allowed properties.| +|`SchemaError_MinimumProperties`| Object property count {0} is less than minimum count of {1}.|The app manifest file failed the `minimumProperties` validation of the schema. Here, {0} represents the number of properties provided and {1} represents the minimum allowed properties.| +|`SchemaError_Required`| Required properties are missing from object: {0}.| The app manifest file failed the `required` validation of the schema. Here, {0} represents the required properties. | +|`SchemaError_AdditionalProperties`| Property {0} hasn't been defined and the schema doesn't allow additional properties.| The app manifest file failed the `additionalProperties` validation of the schema. Here, {0} represents the additional property.| +|`SchemaError_Dependencies`|Dependencies for property {0} failed. Missing required keys.| The app manifest file failed the `dependencies` validation of the schema. Here, {0} represents the property that failed.| +|`SchemaError_Enum`| Value {0} isn't defined in the enum.| The app manifest file failed the `enum` validation of the schema. Here, {0} represents the value that isn't in the enum.| +|`SchemaError_AllOf`| JSON doesn't match all schemas from "allOf".| The app manifest file failed the `allOf` validation of the schema.| +|`SchemaError_AnyOf`| JSON doesn't match any schemas from "anyOf".| The app manifest file failed the `anyOf` validation of the schema.| +|`SchemaError_OneOf`| JSON is valid against more than one schema from "oneOf".| The app manifest file failed the `oneOf` validation of the schema.| +|`SchemaError_Not`| JSON is valid against schema from "not".| The app manifest file failed the `not` validation of the schema.| +|`SchemaError_Id`| Duplicate schema ID {0} encountered.| The app manifest file failed the `id` validation of the schema. Here, {0} represents the `id` of the schema.| +|`SchemaError_PatternProperties`| Couldn't test property names with regex pattern "{0}".| The app manifest file failed the `patternProperties` validation of the schema. Here, {0} represents the pattern for the properties.| +|`SchemaError_Valid`| Schema always fails validation.| The app manifest file failed the `valid` validation of the schema.| +|`SchemaError_Const`| Value {0} doesn't match constant {1}.| The app manifest file failed the `const` validation of the schema. Here, {0} represents the value that failed and {1} represents the correct value.| +|`SchemaError_Contains`| Array doesn't contain a required item.| The app manifest file failed the `contains` validation of the schema.| +|`SchemaError_Then`|JSON doesn't match schema from "then".| The app manifest file failed the `then` validation of the schema.| +|`SchemaError_Else`| JSON doesn't match schema from "else".|The app manifest file failed the `else` validation of the schema.| +| `SchemaError_Other`| The value doesn't conform to the schema for this property.| The app manifest file failed other unhandled validations of the schema.| +|`ActivityGroupIdFromActivitiesTypeValidation` | ActivityGroupId field in ActivityType must be a subset of ID field in ActivityGroup.| The `ActivityGroupId` field in `ActivityType` isn't a subset of the `Id` field in `ActivityGroup` in the app manifest.| +|`ActivityTypesMustExistWithActivitiesGroupValidation` | Manifest shouldn't contain Activity Group when Activity Types is missing.| The `ActivityGroup` property is available, but the `ActivityType` property is missing in the app manifest.| +|`ApiSecretServiceAuthTypeComposeExtensionContainsMsftEntraConfiguration`|API-based compose extension with apiSecretServiceAuth authType have microsoftEntraConfiguration defined.| The API-based compose extension has `microsoftEntraConfiguration` defined in the app manifest.| +|`ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretRegistrationId`| API-based compose extension with apiSecretServiceAuth authType have no apiSecretRegistrationId defined.| The API-based compose extension with `apiSecretServiceAuth` authType without `apiSecretRegistrationId` defined in the app manifest.| +|`ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretServiceAuthConfiguration` | API-based compose extension with apiSecretServiceAuth authType have no apiSecretServiceConfiguration.| The API-based compose extension doesn't set `supportsSingleSignOn` to `true` in the app manifest.| +|`ApiBasedComposeExtensionManifestCommandIdsNotIncludedInOperationIdsOnApiSpecficationFile`| Command Ids on manifest aren't included in Operation Ids on API specification file.| The error that occurs when the `Command Ids` in the app manifest aren't included in `Operation Ids` on API specification file.| +|`ApiBasedComposeExtensionWithBotId`| API-based compose extension can't have botId defined.| The API-based compose extension has `botId` defined in the app manifest.| +|`ApiBasedComposeExtensionWithCanUpdateConfiguration`|API-based compose extension can't have canUpdateConfiguration defined on manifest.| The API-based compose extension has `canUpdateConfiguration` defined in the app manifest.| +|`ApiBasedComposeExtensionWithNoParameter`| API-based compose extension must have command parameters defined on manifest.| The API-based compose extension doesn't have any command parameters defined in the app manifest.| +|`ApiBasedComposeExtensionApiResponseRenderingTemplateFileNullOrEmpty`| API-based compose extension must have apiResponseRenderingTemplateFile defined on manifest.| The API-based compose extension doesn't have the `apiResponseRenderingTemplateFile` defined in the app manifest.| +|`ApiBasedComposeExtensionApiSpecificationFileNullOrEmpty`| API-based compose extension must have apiSpecificationFile defined on manifest. | The API-based compose extension doesn't have the `apiSpecificationFile` defined in the app manifest.| +|`MsftEntraAuthTypeComposeExtensionContainsApiSecretServiceConfiguration`|API-based compose extension with microsoftEntra authType have apiSecretServiceConfiguration defined. |The API-based compose extension has `apiSecretServiceConfiguration` defined in the manifest.| +|`MsftEntraAuthTypeComposeExtensionContainsNoMsftEntraConfiguration`|API-based compose extension with microsoftEntra authType have no microsoftEntraConfiguration defined.| The API-based compose extension doesn't have `microsoftEntraConfiguration` defined in the app manifest.| +|`MsftEntraAuthTypeComposeExtensionWebApplicationInfoOrResourceNotDefined`|API-based compose extension with microsoftEntra authType have no webApplicationInfo or resource defined on manifest.| The API-based compose extension with `microsoftEntra` authType doesn't have `webApplicationInfo` or `resource` defined in the app manifest.| +|`MsftEntraAuthTypeComposeExtensionResourceURLNotMatchServerURLOnApiSpec` |API-based compose extension with microsoftEntra authType resource URL on manifest doesn't match server URL on API specification file.| The API-based compose extension with `microsoftEntra` authType resource URL in the app manifest doesn't match server URL in the API specification file.| +|`NoAuthTypeComposeExtensionContainsAuthConfiguration` |API-based compose extension with none authType have auth-related configuration defined.| The API-based compose extension with authType `microsoftEntraConfiguration` or `apiSecretServiceConfiguration` isn't defined in the app manifest.| +|`ApiSpecificationFileContainUnsupportedHttpMethod`| API-based compose extension have server urls that have unsupported http method defined on apiSpecificationFile. Currently only GET and POST are supported.| The API-based compose extension has an unsupported `http` method defined in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequiredParameterContainUnsupportedLocation`| API-based compose extension have unsupported parameter location defined on apiSpecificationFile for {0}. Currently only path and query supported.| The API-based compose extension has an unsupported parameter location defined in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequestBodyContainUnsupportedMediaType`|API-based compose extension have unsupported media type defined in request body on apiSpecificationFile. Currently only application/json is supported.| The API-based compose extension has an unsupported `media` type defined in request body in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequestBodyContainUnsupportedSchemaType`| API-based compose extension have unsupported schema type defined in request body on apiSpecificationFile. Currently arrays aren't supported.| The API-based compose extension has an unsupported schema type defined in request body in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequestBodySchemaContainKeywords` | API-based compose extension have keywords.|The API-based compose extension has keywords defined in request body in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequiredParameterOrPropertyNotDefinedOnManifest`| API-based compose extension have required parameters or properties {0} not defined on manifest.| The API-based compose extension has a `required` parameter, which isn't defined in the app manifest.| +|`ApiSpecificationFileResponseContainUnsupportedMediaType`| API-based compose extension have unsupported media type defined in response on apiSpecificationFile. Currently only application/json supported. | The API-based compose extension has an unsupported `media` type defined in response in the `apiSpecificationFile`.| +|`ApiSpecificationFileServerUrlsContainHttp`| API-based compose extension have server urls that have http protocol defined on apiSpecificationFile.| The API-based compose extension has server urls that contain `http` protocol in the `apiSpecificationFile`.| +|`ApiSpecificationFileServerUrlsContainInvalidUrl`| API-based compose extension have server urls that are invalid URL defined on apiSpecificationFile.| The API-based compose extension has an `invalid` URL defined in the `apiSpecificationFile`.| +|`ServerUrlsMissingOnApiSpecificationFile`| API-based compose extension have no server urls defined on apiSpecificationFile.| The error that occurs The API-based compose extension has no server urls defined in the `apiSpecificationFile`.| +|`BotBasedComposeExtensionApiResponseRenderingTemplateFileExists` |Bot based compose extension can't have apiResponseRenderingTemplateFile defined.|The bot-based compose extension has an `apiResponseRenderingTemplateFile` property defined in the app manifest.| +|`BotBasedComposeExtensionApiSpecificationFileExists` |Bot based compose extension can't have apiSpecificationFile defined.|The bot-based compose extension has an API specification file defined in the app manifest.| +|`BotBasedComposeExtensionBotIdNotGuid` |Bot based compose extension must have GUID botId.| The bot-based compose extension `botId` isn't GUID.| +|`CommonAppIdIsNotGuid`| Field 'ID' isn't a Guid in the manifest.| The `appId` isn't GUID.| +|`CommonAppIdIsRequiredField`| Required field 'ID' is missing in the manifest.| The `appId` isn't provided.| +|`CommonManifestVersionIsRequiredField`|The required field in manifest 'manifest Version' is missing.| The manifest version isn't provided.| +|`CommonSchemaUrlIsRequiredField`| Schema URL must be present.| The schema isn't provided.| +|`DashboardCardBothIconNameAndUrlPresent`| Dashboard cards icon shouldn't contain both icon name and URL.| Dashboard cards icon mustn't contain both icon name and URL.| +|`DashboardCardEntityIdsAreNotUnique`| Dashboard card entity IDs should be unique.| The returned entity Id for a dashboard card isn't unique within the manifest.| +|`DeveloperNameIsRequiredField`| Required field 'developer name' is missing in the manifest.| The developer name isn't provided.| +|`DeveloperNameLengthCheck`| Maximum character length must not exceed 32 chars.| The developer name is more than 32 characters long.| +|`DeveloperPrivacyUrlIsRequiredField`| Required field 'privacyUrl' is missing in the manifest.| The `privacyUrl` is missing in the app manifest. | +|`DeveloperPrivacyUrlMustBeHttps`| Privacy URL must be secured Support URL (HTTPS).| The developer privacy URL didn't use HTTPS.| +|`DeveloperTermsOfUseUrlIsRequiredField`| Required field 'termsOfUseUrl' is missing in the manifest.| The **termsOfUseUrl** is missing from the manifest.| +|`DeveloperTermsOfUseUrlMustBeHttps`|Terms Of Use URL must be secured Support URL (HTTPS).| The developer terms of use URL didn't use HTTPS.| +|`DeveloperWebsiteUrlIsRequiredField`| Required field 'websiteUrl' is missing in the manifest.| The developer website URL is missing.| +|`DeveloperWebsiteUrlMustBeHttps`| Website URL must be secured Support URL (HTTPS).| The developer website URL didn't use HTTPS.| +|`UniqueActivityTypeInActivitiesValidation` |Manifest shouldn't contain duplicate Activity Type.| The activity type isn't unique in the app manifest.| +|`UniqueIdInActivitiesGroupValidation` |Manifest shouldn't contain duplicate ID in Activity Groups.| The activity group ID isn't unique in the app manifest.| +|`FullDescriptionCannotBeEmpty` |Full Description can't be empty.| The full description is empty.| +|`FullDescriptionLengthCheck`| Maximum character length for long description must not exceed 4,000 chars.| The full description length is more than 4,000 characters.| +|`GroupChatForBotsLessThanV13`| Please upgrade the version of manifest to V1.3 as group chat bot is supported in manifest v1.3 onwards.| The `groupChat` scope for bots isn't supported in the app manifest version 1.3 and below.| +|`GroupChatForConfigurableTabsLessThanV13`| Please upgrade the version of manifest to V1.3 as group chat configurable tabs is supported in manifest v1.3 onwards.|The `groupChat` scope for configurable tabs isn't supported in the app manifest version 1.3 and below.| +|`InvalidColor32x32IconHeightAndWidth`|Color 32x32 icon should be 32x32 with only white and transparent.| The color 32x32 icon doesn't have the correct dimensions.| +|`InvalidColorIconHeightAndWidth`| Color Icon isn't as per the required dimension.| The dimensions of the color icon are incorrect.| +|`InvalidOutlineIconHeightAndWidth` | Small icon should be 32x32 with only white and transparent.| The dimensions of the outline icon are incorrect.| +|`ParameterOnManifestNotDefinedOnApiSpecFile` | API-based compose extension have parameters {0} on manifest not defined on API specification file.| The API-based compose extension parameters in the app manifest aren't defined in the API specification file. | +|`ReservedActivitiesValidation`| Manifest shouldn't contain reserved Activity Type 'systemDefault'.| The `systemDefault` activity type is defined in the app manifest.| +|`ReservedStaticTabNameShouldBeNull`| Reserved tab "Name" property shouldn't be specified.| The reserved `staticTabs` name property was specified.| +|`ShortDescriptionCannotBeEmpty`| Short Description canΓÇÖt be empty| The short description was empty.| +|`ShortDescriptionLengthCheck`|Maximum character length for short description must not exceed 80 chars.| The short description is more than 80 characters long.| +|`ShortNameEqualsReservedName`|Short name of the app can't be reserved name.| The short name is a reserved name.| +|`ShortNameIsRequiredField`| Short name of the app can't be empty.| The short name is empty.| +|`StaticTabNameCouldNotBeEmpty`| Non-reserved staticTabs "Name" property can't be empty.| The `staticTabs` name property is empty.| +|`BotIdIsNotGuid`| BotId isn't a Guid value.|The `BotId` value in the app manifest isn't a GUID.| +|`VersionCannotBeEmpty`| Required field "version" is missing in the manifest.| The app package version is missing.| +|`VersionContainsOnlyNumbersDotSeparated`| App version supports only numbers in the '#.#.#' format.| The version in the app package isn't matched by the pattern, `#.#.#`.| +|`VersionHasMajorLessThan1`|App version shouldn't start with '0'. Ex: 0.0.1 or 0.1 aren't valid app versions and 1.0 / 1.5.1 / 1.0.0 / 2.5.0 are valid app versions. In case of new update in manifest to an existing app in store. | The app version is less than 1.0. You need to upgrade your app version. For example, if the current version of your app in the store is 1.0 and youΓÇÖre submitting an update for validation, the app version must be higher than 1.0.| +|`ShortNameLengthCheck` |Maximum character length for Short Name must not exceed 30 chars.|The short name exceeds 30 characters.| +|`ApiSpecificationFileParameterContainUnsupportedSchemaType` |API-based compose extension have unsupported parameter schema type defined on apiSpecificationFile.Arrays aren't supported.|The API-based compose extension has an unsupported parameter schema type defined in the `apiSpecificationFile`.| ++</details> + ## Examples ### Example 1: Publish an app to the app catalog |
v1.0 | Tiindicator Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-delete.md | DELETE /security/tiIndicators/{id} | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Tiindicator Deletetiindicators | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-deletetiindicators.md | POST /security/tiIndicators/deleteTiIndicators | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Tiindicator Deletetiindicatorsbyexternalid | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-deletetiindicatorsbyexternalid.md | POST /security/tiIndicators/deleteTiIndicatorsByExternalId | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Tiindicator Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-get.md | This method supports some of the OData query parameters to help customize the re | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Tiindicator Submittiindicators | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-submittiindicators.md | POST /security/tiIndicators/submitTiIndicators | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Tiindicator Updatetiindicators | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicator-updatetiindicators.md | POST /security/tiIndicators/updateTiIndicators | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Tiindicators List | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicators-list.md | This method supports some of the OData query parameters to help customize the re | Name |Description| |:-|:-|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Tiindicators Post | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/tiindicators-post.md | POST /security/tiIndicators | Name | Description | |:--|:--|-| Authorization | Bearer {code} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | User Changepassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-changepassword.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Enable the user to update their password. Any user can update their password without belonging to any administrator role. +Update the signed-in [user's](../resources/user.md) password. Any user can update their password without belonging to any administrator role. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | User Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-delta.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Get newly created, updated, or deleted users without having to perform a full read of the entire user collection. See [change tracking](/graph/delta-query-overview) for details. +Get newly created, updated, or deleted users without having to perform a full read of the entire [user](../resources/user.md) collection. See [change tracking](/graph/delta-query-overview) for details. > [!NOTE] > Changes to the **licenseAssignmentStates** property are currently not tracked. You only need to specify any desired query parameters once upfront. In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response, as that URL already includes the encoded, desired parameters. -| Query parameter | Type |Description| +| 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 for the same user collection, 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 there are further changes to be tracked in the same user collection. | |
v1.0 | User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-get.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the properties and relationships of user object. +Retrieve the properties and relationships of [user](../resources/user.md) object. This operation returns by default only a subset of the more commonly used properties for each user. These _default_ properties are noted in the [Properties](../resources/user.md#properties) section. To get properties that are _not_ returned by default, do a [GET operation](user-get.md) for the user and specify the properties in a `$select` OData query option. Because the **user** resource supports [extensions](/graph/extensibility-overview), you can also use the `GET` operation to get custom properties and extension data in a **user** instance. |
v1.0 | User List Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-approleassignments.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the list of [appRoleAssignments](../resources/approleassignment.md) that a user has been granted. This operation also returns app role assignments granted to groups that the user is a direct member of. +Retrieve the list of [appRoleAssignments](../resources/approleassignment.md) that a [user](../resources/user.md) has been granted. This operation also returns app role assignments granted to groups that the user is a direct member of. > [!IMPORTANT] > To ensure complete results for users with many indirect app role assignments, use the **ConsistencyLevel** header set to `eventual` and `$count`, as described in [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries#group-properties). For an example, see [Example 1](#example-1-list-approleassignments-granted-to-a-user). |
v1.0 | User List Memberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-memberof.md | Choose the permission or permissions marked as least privileged for this API. Us ### Permissions for the signed-in user's direct memberships -<!-- { "blockType": "permissions", "name": "user_list_memberof_1" } --> +<!-- { "blockType": "permissions", "name": "user_list_memberof" } --> ### Permissions for another user's direct memberships |
v1.0 | User List Transitivememberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-list-transitivememberof.md | Choose the permission or permissions marked as least privileged for this API. Us ### Permissions for the signed-in user's memberships -<!-- { "blockType": "permissions", "name": "user_list_transitivememberof_1" } --> +<!-- { "blockType": "permissions", "name": "user_list_transitivememberof" } --> ### Permissions for another user's memberships |
v1.0 | User Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-approleassignments.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Use this API to assign an app role to a user. To grant an app role assignment to a user, you need three identifiers: +Use this API to assign an [app role](../resources/approle.md) to a [user](../resources/user.md), creating an [appRoleAssignment](../resources/approleassignment.md) object. To grant an app role assignment to a user, you need three identifiers: - `principalId`: The `id` of the user to whom you are assigning the app role. - `resourceId`: The `id` of the resource `servicePrincipal` that has defined the app role. |
v1.0 | User Post Messages | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/user-post-messages.md | POST /me/mailFolders/{id}/messages POST /users/{id | userPrincipalName}/mailFolders/{id}/messages ``` ## Request headers-| Name | Type | Description| -|:|:--|:-| -| Authorization | string | Bearer {token}.| -| Content-Type | string | Nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content | +| Name | Description| +|:-|:-| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +| Content-Type | The nature of the data in the body of an entity. Required. <br/> Use `application/json` for a JSON object and `text/plain` for MIME content | ## Request body When using JSON format, provide a JSON representation of the [message](../resources/message.md) object. |
v1.0 | Virtualendpoint Retrievetenantencryptionsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualendpoint-retrievetenantencryptionsetting.md | Retrieve the encryption setting of the tenant associated with the current authen 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|Least privileged permissions|Higher privileged permissions| -|:|:|:| -|Delegated (work or school account)|CloudPC.Read.All|CloudPC.ReadWrite.All| -|Delegated (personal Microsoft account)|Not supported.|Not supported.| -|Application|Not supported.|Not supported.| +<!-- { "blockType": "permissions", "name": "virtualendpoint_retrievetenantencryptionsetting" } --> ## HTTP request |
v1.0 | Virtualeventregistrationconfiguration List Questions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationconfiguration-list-questions.md | GET https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c-5 [!INCLUDE [sample-code](../includes/snippets/php/list-questions-virtualeventregistration-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/list-questions-virtualeventregistration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Virtualeventregistrationconfiguration Post Questions | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationconfiguration-post-questions.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/post-custom-question-virtualeventregistration-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/post-custom-question-virtualeventregistration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] POST https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1c- [!INCLUDE [sample-code](../includes/snippets/php/post-predefined-question-virtualeventregistration-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/post-predefined-question-virtualeventregistration-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Virtualeventregistrationquestionbase Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/virtualeventregistrationquestionbase-delete.md | DELETE https://graph.microsoft.com/beta/solutions/virtualEvents/webinars/f4b39f1 [!INCLUDE [sample-code](../includes/snippets/php/delete-virtualeventregistrationquestion-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/delete-virtualeventregistrationquestion-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Workbookformatprotection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookformatprotection-get.md | Retrieve the properties and relationships of formatprotection 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": "formatprotection_get" } --> +<!-- { "blockType": "permissions", "name": "workbookformatprotection_get" } --> ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Workbookformatprotection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workbookformatprotection-update.md | Update the properties of formatprotection 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": "formatprotection_update" } --> +<!-- { "blockType": "permissions", "name": "workbookformatprotection_update" } --> ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Workingtimeschedule Endworkingtime | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workingtimeschedule-endworkingtime.md | + + Title: "workingTimeSchedule: endWorkingTime" +description: "Trigger the policies associated with the end of working hours for a specific user." ++ms.localizationpriority: medium ++++# workingTimeSchedule: endWorkingTime ++Namespace: microsoft.graph +++Trigger the policies associated with the end of working hours for a specific user. ++## 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": "workingtimeschedule_endworkingtime" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /users/{userId}/solutions/workingTimeSchedule/endWorkingTime +``` ++## Path parameters ++|Parameter|Type|Description| +|:|:|:| +|userId|String|ID of the user whose working time ended.| ++## 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 `202 Accepted` response code. ++## Examples ++### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "workingtimeschedulethis.endworkingtime" +} +--> +``` http +POST https://graph.microsoft.com/beta/users/ccdf8279-8a3f-4c10-af1a-4a7f46b1489f/solutions/workingTimeSchedule/endWorkingTime +``` ++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 202 Accepted +``` |
v1.0 | Workingtimeschedule Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workingtimeschedule-get.md | + + Title: "Get workingTimeSchedule" +description: "Read the properties and relationships of a workingTimeSchedule object." ++ms.localizationpriority: medium ++++# Get workingTimeSchedule ++Namespace: microsoft.graph +++Read the properties and relationships of a [workingTimeSchedule](../resources/workingtimeschedule.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": "workingtimeschedule-get-permissions" +} +--> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /users/{usersId}/solutions/schedule +``` ++## Optional query parameters ++This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response. ++## 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 [workingTimeSchedule](../resources/workingtimeschedule.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "get_workingtimeschedule" +} +--> +``` http +GET https://graph.microsoft.com/beta/users/ccdf8279-8a3f-4c10-af1a-4a7f46b1489f/solutions/schedule +``` +++### 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.workingTimeSchedule" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.teams.workingTime.workingTimeSchedule", + "id": "da5f72af-450e-56fc-10d7-afc9acb40cc0" + } +} +``` + |
v1.0 | Workingtimeschedule Startworkingtime | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/api/workingtimeschedule-startworkingtime.md | + + Title: "workingTimeSchedule: startWorkingTime" +description: "Trigger the policies associated with the start of working hours for a specific user." ++ms.localizationpriority: medium ++++# workingTimeSchedule: startWorkingTime ++Namespace: microsoft.graph +++Trigger the policies associated with the start of working hours for a specific user. ++## 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": "workingtimeschedule_startworkingtime" } --> ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /users/{userId}/solutions/workingTimeSchedule/startWorkingTime +``` ++## Path parameters ++|Parameter|Type|Description| +|:|:|:| +|userId|String|ID of the user whose working hours started.| ++## 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 `202 Accepted` response code. ++## Examples ++### Request ++The following example shows a request. +<!-- { + "blockType": "request", + "name": "workingtimeschedulethis.startworkingtime" +} +--> +``` http +POST https://graph.microsoft.com/beta/users/ccdf8279-8a3f-4c10-af1a-4a7f46b1489f/solutions/workingTimeSchedule/startWorkingTime +``` +++### Response ++The following example shows the response. ++<!-- { + "blockType": "response", + "truncated": true +} +--> +``` http +HTTP/1.1 202 Accepted +``` |
v1.0 | Accesspackageassignmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/accesspackageassignmentrequest.md | In [Microsoft Entra Entitlement Management](entitlementmanagement-overview.md), | [Create](../api/entitlementmanagement-post-assignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Create a new **accessPackageAssignmentRequest**. | | [Get](../api/accesspackageassignmentrequest-get.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Read properties and relationships of an **accessPackageAssignmentRequest** object. | | [Delete](../api/accesspackageassignmentrequest-delete.md) |None | Delete an **accessPackageAssignmentRequest**. |-|[Filter by current user](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.| |[Cancel](../api/accesspackageassignmentrequest-cancel.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Cancel an **accessPackageAssignmentRequest** object that is in a cancelable state.|+|[Filter by current user](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.| | [Reprocess](../api/accesspackageassignmentrequest-reprocess.md) | None | Automatically retry a user's request for access to an access package.|+| [Resume](../api/accesspackageassignmentrequest-resume.md) | None | Resume a user's access package request after waiting for a callback from a custom extension.| | [List (deprecated)](../api/entitlementmanagement-list-accesspackageassignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) collection | Retrieve a list of **accesspackageassignmentrequest** objects. **This API will be retired soon. Use the [List assignmentRequests](../api/entitlementmanagement-list-assignmentrequests.md) API instead.** | | [Create (deprecated)](../api/entitlementmanagement-post-accesspackageassignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Create a new **accessPackageAssignmentRequest**. **This API will be retired soon. Use the [Create accessPackageAssignmentRequest](../api/entitlementmanagement-post-assignmentrequests.md) API instead.** | |
v1.0 | Adminreportsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/adminreportsettings.md | Represents the tenant-level settings for Microsoft 365 reports. |Method|Return type|Description| |:|:|:|-|[Get](../api/adminreportsettings-get.md)|[adminReportSettings](../resources/adminreportsettings.md)|Get the tenant-level settings for Microsoft 365 Reports.| -|[Update](../api/adminreportsettings-update.md)|[adminReportSettings](../resources/adminreportsettings.md)|Update tenant-level settings for Microsoft 365 Reports.| +|[Get](../api/adminreportsettings-get.md)|[adminReportSettings](../resources/adminreportsettings.md)|Get the tenant-level settings for Microsoft 365 reports.| +|[Update](../api/adminreportsettings-update.md)|[adminReportSettings](../resources/adminreportsettings.md)|Update tenant-level settings for Microsoft 365 reports.| ## Properties | 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. | ## JSON representation |
v1.0 | Application | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/application.md | This resource supports: | appId | String | The unique identifier for the application that is assigned by Microsoft Entra ID. Not nullable. Read-only. Alternate key. Supports `$filter` (`eq`). | |applicationTemplateId | String | Unique identifier of the [applicationTemplate](../resources/applicationtemplate.md). Supports `$filter` (`eq`, `not`, `ne`). Read-only. `null` if the app wasn't created from an application template.| | appRoles | [appRole](approle.md) collection | The collection of roles defined for the application. With [app role assignments](approleassignment.md), these roles can be assigned to users, groups, or service principals associated with other applications. Not nullable. |-|authenticationBehaviors|[authenticationBehaviors](../resources/authenticationbehaviors.md)| The collection of authentication behaviors set for the application. Authentication behaviors are unset by default and must be explicitly enabled (or disabled). Returned only on `$select`. <br/><br/> For more information about authentication behaviors, see [Manage application authenticationBehaviors to avoid unverified use of email claims for user identification or authorization](/graph/applications-authenticationbehaviors).| +|authenticationBehaviors|[authenticationBehaviors](../resources/authenticationbehaviors.md)| The collection of breaking change behaviors related to token issuance that are configured for the application. Authentication behaviors are unset by default (`null`) and must be explicitly enabled or disabled. Nullable. Returned only on `$select`. <br/><br/> For more information about authentication behaviors, see [Manage application authenticationBehaviors to avoid unverified use of email claims for user identification or authorization](/graph/applications-authenticationbehaviors).| |certification|[certification](certification.md)|Specifies the certification status of the application.| | createdDateTime | DateTimeOffset | The date and time the application was registered. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. <br><br> Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, and `eq` on `null` values) and `$orderby`. | |defaultRedirectUri|String|The default redirect URI. If specified and there's no explicit redirect URI in the sign-in request for SAML and OIDC flows, Microsoft Entra ID sends the token to this redirect URI. Microsoft Entra ID also sends the token to this default URI in SAML IdP-initiated single sign-on. The value must match one of the configured redirect URIs for the application.| |
v1.0 | Approleassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/approleassignment.md | Title: "appRoleAssignment resource type" -description: "Used to record when a user, group, or service principal is assigned to an app role on an application's service principal. You can create, read and delete app role assignments." +description: "Used to record when a user, group, or service principal is assigned to an app role on an application's service principal. You can create, read, and delete app role assignments." ms.localizationpriority: high doc_type: resourcePageType Used to record when a user, group, or service principal is assigned an app role An app role assignment is a relationship between the assigned principal (a user, a group, or a service principal), a resource application (the app's service principal) and an app role defined on the resource application. -When the [app role](approle.md) which has been assigned to a principal has a non-empty **value** property, this will be included in the **roles** claim of tokens where the subject is the assigned principal (e.g. SAML responses, ID tokens, access tokens identifying a signed-in user, or an access token identifying a service principal). Applications and APIs use these claims as part of their authorization logic. +When the [app role](approle.md) that has been assigned to a principal has a nonempty **value** property, this is included in the **roles** claim of tokens where the subject is the assigned principal (for example, SAML responses, ID tokens, access tokens identifying a signed-in user, or an access token identifying a service principal). Applications and APIs use these claims as part of their authorization logic. A user can be assigned an app role directly. If an app role is assigned to a group, direct members of the group are also considered to have been assigned the app role. When a user is assigned an app role for an application, a tile for that application is displayed in the user's [MyApps portal](/azure/active-directory/user-help/my-apps-portal-end-user-access) and [Microsoft 365 app launcher](https://support.office.com/article/meet-the-office-365-app-launcher-79f12104-6fed-442f-96a0-eb089a3f476a). An app role assignment where the assigned principal is a service principal is an ## Methods |Method|Return type|Description| |:|:|:|-|[List appRoleAssignments granted to a group](../api/group-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[List appRoleAssignments granted to a user](../api/user-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[List appRoleAssignments granted to a service principal](../api/serviceprincipal-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[List appRoleAssignments granted to users, groups, and client service principals for a resource service principal](../api/serviceprincipal-list-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[Grant an appRole to a group](../api/group-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Grant an appRole to a user](../api/user-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Grant an appRole to a service principal](../api/serviceprincipal-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Grant a user, group, or client service principal an appRoleAssignment for a resource service principal](../api/serviceprincipal-post-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object. -|[Get appRoleAssignment](../api/approleassignment-get.md)|[appRoleAssignment](../resources/approleassignment.md)|Get a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Dlete an appRoleAssignment from a group](../api/group-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| -|[Delete an appRoleAssignment from a user](../api/user-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| -|[Delete an appRoleAssignment from a service principal](../api/serviceprincipal-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| -|[Delete an appRoleAssignment granted to a user, group, or client service principal for a resource service principal](../api/serviceprincipal-delete-approleassignedto.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| +|[List app role assignments for a group](../api/group-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a group.| +|[List app role assignments for a user](../api/user-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a user.| +|[List app role assignments for a client service principal](../api/serviceprincipal-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a client service principal.| +|[List app role assignments for users, groups, and client service principals for a resource service principal](../api/serviceprincipal-list-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for users, groups, and client service principals for a specified resource service principal.| +|[Grant app role to a group](../api/group-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a group.| +|[Grant app role to a user](../api/user-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a user.| +|[Grant app role to a client service principal](../api/serviceprincipal-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a client service principal.| +|[Grant app role assignment to user, group, or client service principal for a resource service principal](../api/serviceprincipal-post-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object to a user, group, or client service principal for a specified resource service principal.| +|[Get app role assignment](../api/approleassignment-get.md)|[appRoleAssignment](../resources/approleassignment.md)|Get an [appRoleAssignment](../resources/approleassignment.md) object assigned to a user, group, or client service principal for a resource service principal.| +|[Delete app role assignment for a group](../api/group-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a group.| +|[Delete app role assignment for a user](../api/user-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a user.| +|[Delete app role assignment for a client service principal](../api/serviceprincipal-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a client service principal.| +|[Delete app role assignment for user, group, or client service principal to a resource service principal](../api/serviceprincipal-delete-approleassignedto.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a user, group, or client service principal for a specified resource service principal.| ## Properties An app role assignment where the assigned principal is a service principal is an | principalDisplayName | String |The display name of the user, group, or service principal that was granted the app role assignment. Read-only. Supports `$filter` (`eq` and `startswith`). | | resourceId | Guid |The unique identifier (**id**) for the resource [service principal](serviceprincipal.md) for which the assignment is made. Required on create. Supports `$filter` (`eq` only). | | resourceDisplayName | String | The display name of the resource app's service principal to which the assignment is made. |-| appRoleId | Guid | The identifier (**id**) for the [app role](approle.md) which is assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application has not declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create. | +| appRoleId | Guid | The identifier (**id**) for the [app role](approle.md) that is assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application hasn't declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create. | ## JSON representation |
v1.0 | Attachment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/attachment.md | Title: "attachment resource type" -description: "You can add related content to an event," +description: "The base type for several types of attachments on a user, message, task, or group post." ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] +The base type for several types of attachments on a user, message, task, or group post that serves as the base resource for the following derived types of attachments: ++* A file ([fileAttachment](../resources/fileattachment.md) resource) +* An item (contact, event, or message, represented by an [itemAttachment](../resources/itemattachment.md) resource) +* A link to a file ([referenceAttachment](../resources/referenceattachment.md) resource) You can add related content to a user [event](../resources/event.md), [message](../resources/message.md), [Outlook task](../resources/outlooktask.md), or group [post](../resources/post.md) in the form of an attachment. + Events in group calendars do not support attachments. Outlook tasks do not support reference attachments. -**attachment** is the base resource for the following derived types of attachments: --* A file ([fileAttachment](../resources/fileattachment.md) resource) -* An item (contact, event or message, represented by an [itemAttachment](../resources/itemattachment.md) resource) -* A link to a file ([referenceAttachment](../resources/referenceattachment.md) resource) - >**Note**: If you're attaching a file to a group post, or attaching an item to an event, message, or group post, limit the size of the attachment to 3 MB. > > If you're attaching a file under 3 MB, you can [add the file attachment to a user event](../api/event-post-attachments.md), [to a message](../api/message-post-attachments.md), or [to a group post](../api/post-post-attachments.md). |
v1.0 | Authenticationbehaviors | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/authenticationbehaviors.md | Namespace: microsoft.graph Describes the authentication behaviors set in the context of an [application](application.md). Authentication behaviors are Boolean flags that provide applications flexibility in adopting breaking-change behaviors related to token issuance. These updated token issuance behaviors can be related to security mitigations, security improvements, or feature deprecations. -Applications can adopt new breaking changes by enabling a behavior (set the behavior to `true`), or continue using pre-existing behavior by disabling it (by setting the behavior to `false`). For more information about managing authentication behaviors, see [Manage application authenticationBehaviors](/graph/applications-authenticationbehaviors). +Applications can adopt new breaking changes by enabling a behavior (set the behavior to `true`), or continue using preexisting behavior by disabling it (by setting the behavior to `false`). For more information about managing authentication behaviors, see [Manage application authenticationBehaviors](/graph/applications-authenticationbehaviors). ## Properties |Property|Type|Description| |:|:|:|-|removeUnverifiedEmailClaim|Boolean| Removes the `email` claim from tokens sent to an application when the email address's domain can't be verified. | -|requireClientServicePrincipal|Boolean| Requires multitenant applications to have a service principal in the resource tenant as part of authorization checks before they're granted access tokens. This property is only modifiable for multi-tenant resource applications that rely on access from clients without a service principal and had this behavior as set to `false` by Microsoft. Tenant administrators should respond to security advisories sent through Azure Health Service events and the Microsoft 365 message center.| +|blockAzureADGraphAccess|Boolean| If `false`, allows the app to have extended access to Azure AD Graph until June 30, 2025 when Azure AD Graph is fully retired. For more information on Azure AD retirement updates, see [June 2024 update on Azure AD Graph API retirement](https://techcommunity.microsoft.com/t5/microsoft-entra-blog/june-2024-update-on-azure-ad-graph-api-retirement/ba-p/4094534).| +|removeUnverifiedEmailClaim|Boolean| If `true`, removes the `email` claim from tokens sent to an application when the email address's domain can't be verified. | +|requireClientServicePrincipal|Boolean| If `true`, requires multitenant applications to have a service principal in the resource tenant as part of authorization checks before they're granted access tokens. This property is only modifiable for multitenant resource applications that rely on access from clients without a service principal and had this behavior as set to `false` by Microsoft. Tenant administrators should respond to security advisories sent through Azure Health Service events and the Microsoft 365 message center.| ## Relationships None. The following JSON representation shows the resource type. ``` json { "@odata.type": "#microsoft.graph.authenticationBehaviors",+ "blockAzureADGraphAccess": "Boolean", "removeUnverifiedEmailClaim": "Boolean", "requireClientServicePrincipal": "Boolean" } |
v1.0 | Bookingschedulingpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/bookingschedulingpolicy.md | Namespace: microsoft.graph Represents the set of policies that determine how appointments should be created in a Microsoft Bookings calendar. +> [!NOTE] +> +> If the Default Scheduling Policy is enabled at the service level, the values of this resource are limited to those defined in the policy in the [List services](/graph/api/bookingbusiness-list-services) API response. In this case, the client must fall back to the Default Scheduling Policy for the business. + ## Properties | Property | Type |Description| |:|:--|:-| |
v1.0 | Chatmessagereaction | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/chatmessagereaction.md | An entity of type `chatMessageReaction` is returned as part of the [Get channel | Property | Type | Description | |:-|:|:| |createdDateTime|DateTimeOffset|The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|+|displayName|String|The name of the reaction.| |reactionContentUrl|String|The hosted content URL for the custom reaction type. |-|reactionType|String|Supported values are Unicode characters and `custom`. Some backward-compatible reaction types include `like`, `angry`, `sad`, `laugh`, `heart`, and `surprised`. | +|reactionType|String|The reaction type. Supported values include Unicode characters, `custom`, and some backward-compatible reaction types, such as `like`, `angry`, `sad`, `laugh`, `heart`, and `surprised`. | |user|[chatMessageReactionIdentitySet](chatmessagereactionidentityset.md)|The user who reacted to the message.| ## JSON representation The following JSON representation shows the resource type. { "createdDateTime": "String (timestamp)", "reactionContentUrl": "String",+ "displayName": "String", "reactionType": "String", "user": {"@odata.type": "microsoft.graph.chatMessageReactionIdentitySet"} } |
v1.0 | Cloudpc | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/cloudpc.md | Represents a cloud-managed virtual desktop. This Cloud PC is also enrolled in In |[Retry partner agent installation](../api/cloudpc-retrypartneragentinstallation.md)|None|Retry installation for the partner agents that failed to install on the Cloud PC.| |[Validate bulk resize](../api/cloudpc-validatebulkresize.md)|[cloudPcResizeValidateResult](../resources/cloudPcResizeValidationResult.md) collection|Validate that a set of Cloud PC devices meet the requirements to be bulk resized.| |[Create snapshot](../api/cloudpc-createsnapshot.md)|None|Create a snapshot for a specific Cloud PC device.|-|[Get frontline access state](../api/cloudpc-getfrontlinecloudpcaccessstate.md)|[frontlineCloudPcAccessState](#frontlinecloudpcaccessstate-values)|Get the access state of the frontline Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode`, `unknownFutureValue`.| +|[Get frontline access state](../api/cloudpc-getfrontlinecloudpcaccessstate.md)|[frontlineCloudPcAccessState](#frontlinecloudpcaccessstate-values)|Get the access state of the frontline Cloud PC. The possible values are: `unassigned`, `noLicensesAvailable`, `activationFailed`, `active`, `activating`, `standbyMode`, `unknownFutureValue`. The `noLicensesAvailable` member is deprecated and will stop returning on September 30, 2024.| |[Bulk reprovision remote action (deprecated)](../api/manageddevice-bulkreprovisioncloudpc.md) |None|Bulk reprovision a set of Cloud PC devices with Intune managed device IDs. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkReprovision](../resources/cloudpcbulkreprovision.md) resource. | |[Bulk resize (deprecated)](../api/cloudpc-bulkresize.md) |[cloudPcRemoteActionResult](../resources//cloudpcremoteactionresult.md) collection|Perform a bulk resize action to resize a group of Cloud PCs that have successfully passed validation (cloudPC: validateBulkResize). If any devices can't be resized, they're labeled as "resize failed", while the remaining devices are `provisioned` for the resize process. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkResize](../resources/cloudpcbulkresize.md) resource.| |[Bulk restore remote action (deprecated)](../api/manageddevice-bulkrestorecloudpc.md) |[cloudPcBulkRemoteActionResult](../resources/cloudpcbulkremoteactionresult.md)|Restore multiple Cloud PC devices with a single request that includes the IDs of Intune managed devices and a restore point date and time. This API is deprecated and stopped returning data on September 24, 2023. Going forward, use the [cloudPcBulkRestore](../resources/cloudpcbulkrestore.md) resource.| The following table lists the members of an [evolvable enumeration](/graph/best- |Member|Description| |:|:| |unassigned|Set to unassigned if the Cloud PC doesn't consume any shared-use licenses. The default value is `unassigned`.|-|noLicensesAvailable|Indicates that all shared-use licenses are in use.| +|noLicensesAvailable (deprecated)|Indicates that all shared-use licenses are in use. The `noLicensesAvailable` member is deprecated and will stop returning on September 30, 2024.| |activationFailed|Indicates that the frontline Cloud PC activation failed after the user requested a frontline Cloud PC.| |active|Indicates that the frontline Cloud PC is in an active state with a shared-use license assigned, and the user can connect to the Cloud PC.| |activating|Indicates that a user requested to connect the Cloud PC and the service is starting.| |
v1.0 | Devicedetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/devicedetail.md | doc_type: resourcePageType # deviceDetail resource type Namespace: microsoft.graph-Indicates device details associated with a device used for signing in. Includes information like device browser and OS info, if device is Microsoft Entra ID managed. - +Indicates details of the device used in a sign-in activity. Includes information like device browser and OS info and if the device is Microsoft Entra ID-managed. ## Properties | Property | Type |Description| |:|:--|:-|-|browser|String|Indicates the browser information of the used for signing-in.| -|deviceId|String|Refers to the UniqueID of the device used for signing-in.| -|displayName|String|Refers to the name of the device used for signing-in.| +|browser|String|Indicates the browser information of the used in the sign-in. Populated for devices registered in Microsoft Entra.| +|deviceId|String|Refers to the unique ID of the device used in the sign-in. Populated for devices registered in Microsoft Entra.| +|displayName|String|Refers to the name of the device used in the sign-in. Populated for devices registered in Microsoft Entra.| |isCompliant|Boolean|Indicates whether the device is compliant or not.| |isManaged|Boolean|Indicates if the device is managed or not.|-|operatingSystem|String|Indicates the OS name and version used for signing-in.| -|trustType|String|Indicates information on whether the signed-in device is Workplace Joined, AzureAD Joined, Domain Joined. | +|operatingSystem|String|Indicates the OS name and version used in the sign-in.| +|trustType|String|Indicates information on whether the device used in the sign-in is workplace-joined, Microsoft Entra-joined, domain-joined.| ## JSON representation |
v1.0 | Education Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/education-overview.md | Title: "Working with education APIs in Microsoft Graph" -description: "The education APIs in Microsoft Graph enhance Microsoft 365 resources and data with information that is relevant for education scenarios, including schools, students, teachers, classes, enrollments, and assignments. This makes it easy for you to build solutions that integrate with educational resources." +description: "The education APIs in Microsoft Graph enhance Microsoft 365 resources and data with information that is relevant for education scenarios, including schools, students, teachers, classes, enrollments, and assignments." ms.localizationpriority: medium The education APIs include rostering resources and assignments resources that yo ## Authorization -To call the education APIs in Microsoft Graph, your app will need to acquire an access token. For details about access tokens, see [Get access tokens to call Microsoft Graph](/graph/auth/). Your app will also need the appropriate permissions. For more information, see [Education permissions](/graph/permissions-reference#education-permissions). +To call the education APIs in Microsoft Graph, your app needs to acquire an access token. For details about access tokens, see [Get access tokens to call Microsoft Graph](/graph/auth/). Your app also needs the appropriate permissions. For more information, see [Education permissions](/graph/permissions-reference#education-permissions). ### App permissions to enable school IT admins to consent The rostering APIs provide the following key resources: - [educationSchool](educationschool.md) - Represents the school. - [educationClass](educationclass.md) - Represents a class within a school. - [educationTerm](educationterm.md) - Represents a designated portion of the academic year.-- [educationTeacher](educationteacher.md) - Represents a users with the primary role of 'Teacher'.-- [educationStudent](educationstudent.md) - Represents a users with the primary role of 'student'.+- [educationTeacher](educationteacher.md) - Represents a user with the primary role of 'Teacher'. +- [educationStudent](educationstudent.md) - Represents a user with the primary role of 'student'. The rostering APIs support the following scenarios: The following are some common use cases for the assignment-related education API | Read assignment information | An analytics application can get information about assignments and student submissions, including dates and grades. | [Get assignment](../api/educationassignment-get.md) | | Track student submissions | Your app can provide a teacher dashboard that shows how many submissions from students need to be graded. | [Submission resource](educationsubmission.md) | +## Classwork ++You can use Classwork as a one-stop shop to create and organize class resources, including assignments, OneNote Class Notebook pages, web links, files, and Teams channels. This means you no longer have to navigate multiple apps and platforms to find what you need. With Classwork, you can curate a view of content and resources that helps your students navigate the class and see everything in one place. ++The Classwork API provides the following key resources: ++- [educationModule](educationmodule.md) - A module is associated with a class. Represents a group of individual learning resources that are organized in a systematic way. +- [educationModuleResource](educationmoduleresource.md) - A wrapper object that stores the resources associated with a module. The student is unable to update this resource, which is a handout from the teacher to the student with nothing to be turned in. ++The following lists show the scenarios supported by the Classwork API. ++### Modules ++The **educationModule** resource supports the following scenarios: ++- [List modules](../api/educationclass-list-modules.md) +- [Create module](../api/educationclass-post-module.md) +- [Get module](../api/educationmodule-get.md) +- [Update module](../api/educationmodule-update.md) +- [Delete module](../api/educationmodule-delete.md) +- [Pin module](../api/educationmodule-pin.md) +- [Unpin module](../api/educationmodule-unpin.md) +- [Publish module](../api/educationmodule-publish.md) +- [Set up module resources folder](../api/educationmodule-setupresourcesfolder.md) ++### Module resources ++The **educationModuleResource** resource supports the following scenarios: ++- [List module resources](../api/educationmodule-list-resources.md) +- [Create module resource](../api/educationmodule-post-resources.md) +- [Get module resource](../api/educationmoduleresource-get.md) +- [Update module resource](../api/educationmoduleresource-update.md) +- [Delete resource from module](../api/educationmoduleresource-delete.md) ++### Common use cases ++The following table shows some common use cases for the module-related education APIs. ++| Use case | Description | See also | +|:|:--|:-| +| Create a module | Only teachers in a class can create a module. Modules start in the draft state, which means that students don't see the modules until publication. | [Create educationModule](../api/educationclass-post-module.md) | +| List modules | A teacher or an application with application permissions can see all module objects for the class. Students can only see published modules. | [List class modules](../api/educationclass-list-modules.md) | +| Publish a module | Changes the state of an **educationModule** from its original `draft` status to the `published` status. | [educationModule: publish](../api/educationmodule-publish.md) | +| Create a resource in a module | Only teachers can perform this operation. | [Create educationModuleResource](../api/educationmodule-post-resources.md) | +| List module resources | Get all the **educationModuleResource** objects associated with a module. Only teachers, students, and applications with application permissions can perform this operation. | [List module resources](../api/educationmodule-list-resources.md) | + ## School data sync management [School Data Sync](https://sds.microsoft.com/) helps to automate the process of importing and synchronizing roster data from student information systems with Microsoft Entra ID and Microsoft 365. You can use the school data sync management APIs in Microsoft Graph to set up synchronization from either a CSV file or a supported SIS API connector. |
v1.0 | Employeeorgdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/employeeorgdata.md | description: "Represents organization data associated with a user." ms.localizationpriority: medium doc_type: resourcePageType -+ # employeeOrgData resource type |
v1.0 | Enums | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/enums.md | -# provisionState values +### provisionState values | Member | | -- | Namespace: microsoft.graph | provisioningCompleted | | unknownFutureValue | -# approvalOperationStatus values +### approvalOperationStatus values | Member | | -- | Namespace: microsoft.graph | timeout | | unknownFutureValue | -## approverRole values +### approverRole values | Member | | -- | | approver | | owner | -## approvalItemState values +### approvalItemState values | Member | | -- | Namespace: microsoft.graph | pending | | completed | -## approvalItemType values +### approvalItemType values | Member | | -- | Namespace: microsoft.graph | custom | | customAwaitAll | -## responseFeedbackType values +### responseFeedbackType values | Member | | -- | Namespace: microsoft.graph | veryPleasant | | unknownFutureValue | -## responseEmotionType values +### responseEmotionType values | Member | | -- | Namespace: microsoft.graph | sad | | unknownFutureValue | -## virtualEventRegistrationPredefinedQuestionLabel values +### virtualEventRegistrationPredefinedQuestionLabel values | Member | | -- | Namespace: microsoft.graph | organization | | unknownFutureValue | -## fileStorageContainerOwnershipType values +### fileStorageContainerOwnershipType values | Member | | -- | | tenantOwned | | unknownfuturevalue | -## groupAccessType values +### groupAccessType values | Member | | -- | Namespace: microsoft.graph | secret | | public | -## fileStorageContainerStatus values +### fileStorageContainerStatus values | Member | | -- | Namespace: microsoft.graph | active | | unknownfuturevalue | -## siteLockState values +### siteLockState values | Value | | | | unlocked | | lockedReadOnly | -## userDefaultAuthenticationMethod values +### userDefaultAuthenticationMethod values | Member | | -- | Namespace: microsoft.graph | none | | unknownFutureValue | -## applicationKeyUsage values +### applicationKeyUsage values | Member | | -- | Namespace: microsoft.graph | verify | | unknownFutureValue | -## applicationKeyType values +### applicationKeyType values | Member | | -- | Namespace: microsoft.graph | certificate | | unknownFutureValue | -## plannerTaskCompletionRequirements values +### plannerTaskCompletionRequirements values | Member | | -- | Namespace: microsoft.graph | formCompletion | | approvalCompletion | -## plannerApprovalStatus values +### plannerApprovalStatus values | Member | | -- | Namespace: microsoft.graph | cancelled | | unknownFutureValue | -## applicationKeyOrigin values +### applicationKeyOrigin values | Member | | -- | Namespace: microsoft.graph | servicePrincipal | | unknownFutureValue | -## authenticationAttributeCollectionInputType values +### authenticationAttributeCollectionInputType values | Member | | - | Namespace: microsoft.graph | boolean | | unknownFutureValue | -## userType values +### userType values | Member | | - | Namespace: microsoft.graph | guest | | unknownFutureValue | -## assignmentType values +### assignmentType values | Member | | | Namespace: microsoft.graph | unknownFutureValue | | peerRecommeded | -## courseStatus values +### courseStatus values | Member | | - | Namespace: microsoft.graph | inProgress | | completed | -## usqState values +### usqState values | Member | | | Namespace: microsoft.graph | full | | overLimit | -## userPurpose values +### userPurpose values | Member | | | Namespace: microsoft.graph | others | | unknownFutureValue | -## releaseType values +### releaseType values | Member | | - | Namespace: microsoft.graph | generallyAvailable | | unknownFutureValue | -## requiredLicenses values +### requiredLicenses values | Member | | - | Namespace: microsoft.graph | microsoftEntraWorkloadId | | unknownFutureValue | -## recommendationCategory values +### recommendationCategory values | Member | | -- | Namespace: microsoft.graph | identitySecureScore | | unknownFutureValue | -## recommendationFeatureAreas values +### recommendationFeatureAreas values | Member | | | Namespace: microsoft.graph | governance | | unknownFutureValue | -## recommendationPriority values +### recommendationPriority values | Member | | | Namespace: microsoft.graph | medium | | high | -## recommendationStatus values +### recommendationStatus values | Member | | | Namespace: microsoft.graph | postponed | | unknownFutureValue | -## recommendationType values +### recommendationType values | Member | | -- | Namespace: microsoft.graph | aadGraphDeprecationServicePrincipal | | mfaServerDeprecation | -## layoutTemplateType values +### layoutTemplateType values | Member | | | Namespace: microsoft.graph | verticalSplit | | unknownFutureValue | -## conditionalAccessExternalTenantsMembershipKind values +### conditionalAccessExternalTenantsMembershipKind values | Member | | | Namespace: microsoft.graph | enumerated | | unknownFutureValue | -## conditionalAccessGuestOrExternalUserTypes values +### conditionalAccessGuestOrExternalUserTypes values | Member | | - | Namespace: microsoft.graph | serviceProvider | | unknownFutureValue | -## teamTemplateAudience values +### teamTemplateAudience values | Member | | | Namespace: microsoft.graph | public | | unknownFutureValue | -## decisionItemPrincipalResourceMembershipType values +### decisionItemPrincipalResourceMembershipType values | Member | | | Namespace: microsoft.graph | indirect | | unknownFutureValue | -## signInFrequencyAuthenticationType values +### signInFrequencyAuthenticationType values | Member | | | Namespace: microsoft.graph | secondaryAuthentication | | unknownFutureValue | -## signInFrequencyInterval values +### signInFrequencyInterval values | Member | | | | timeBased | | everyTime | -## authenticationProtocol values +### authenticationProtocol values | Member | | | Namespace: microsoft.graph | saml | | unknownFutureValue | -## federatedIdpMfaBehavior values +### federatedIdpMfaBehavior values | Member | | -- | Namespace: microsoft.graph | rejectMfaByFederatedIdp | | unknownFutureValue | -## promptLoginBehavior values +### promptLoginBehavior values | Member | | -- | Namespace: microsoft.graph | disabled | | unknownFutureValue | -## bookingsAvailabilityStatus values +### bookingsAvailabilityStatus values | Member | | | Namespace: microsoft.graph | outOfOffice | | unknownFutureValue | -## accessPackageCustomExtensionHandlerStatus values +### accessPackageCustomExtensionHandlerStatus values | Member | | | Namespace: microsoft.graph | requestReceived | | unknownFutureValue | -## accessPackageSubjectLifecycle values +### accessPackageSubjectLifecycle values | Member | | - | Namespace: microsoft.graph | governed | | unknownFutureValue | -## customExtensionCalloutInstanceStatus values +### customExtensionCalloutInstanceStatus values | Member | | | Namespace: microsoft.graph | waitingForCallback | | unknownFutureValue | -## accessPackageCustomExtensionStage values +### accessPackageCustomExtensionStage values | Member | | -- | Namespace: microsoft.graph | assignmentOneDayBeforeExpiration | | unknownFutureValue | -## accessReviewHistoryStatus values +### accessReviewHistoryStatus values | Member | | | Namespace: microsoft.graph | requested | | unknownFutureValue | -## accessReviewHistoryDecisionFilter values +### accessReviewHistoryDecisionFilter values | Member | | | Namespace: microsoft.graph | notNotified | | unknownFutureValue | -## crossTenantAccessPolicyTargetConfigurationAccessType values +### crossTenantAccessPolicyTargetConfigurationAccessType values | Member | | | Namespace: microsoft.graph | blocked | | unknownFutureValue | -## crossTenantAccessPolicyTargetType values +### crossTenantAccessPolicyTargetType values | Member | | | | user | | group | -## multiTenantOrganizationMemberProcessingStatus values +### multiTenantOrganizationMemberProcessingStatus values | Member | | - | Namespace: microsoft.graph | failed | | unknownFutureValue | -## multiTenantOrganizationMemberRole values +### multiTenantOrganizationMemberRole values | Member | | - | Namespace: microsoft.graph | member | | unknownFutureValue | -## multiTenantOrganizationMemberState values +### multiTenantOrganizationMemberState values | Member | | - | Namespace: microsoft.graph | removed | | unknownFutureValue | -## multiTenantOrganizationState values +### multiTenantOrganizationState values | Member | | - | Namespace: microsoft.graph | inactive | | unknownFutureValue | -## templateApplicationLevel values +### templateApplicationLevel values | Member | | - | Namespace: microsoft.graph | existingPartners | | unknownFutureValue | -## approvalFilterByCurrentUserOptions values +### approvalFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | approver | | unknownFutureValue | -## accessPackageFilterByCurrentUserOptions values +### accessPackageFilterByCurrentUserOptions values | Member | | | | allowedRequestor | | unknownFutureValue | -## userSignInRecommendationScope values +### userSignInRecommendationScope values | Member | | -- | | tenant | | application | -## incomingTokenType values +### incomingTokenType values | Member | | - | Namespace: microsoft.graph | unknownFutureValue | | remoteDesktopToken | -## protocolType values +### protocolType values | Member | | | Namespace: microsoft.graph | authenticationTransfer | | nativeAuth | -## accessReviewInstanceDecisionItemFilterByCurrentUserOptions values +### accessReviewInstanceDecisionItemFilterByCurrentUserOptions values | Member | | | | reviewer | | unknownFutureValue | -## accessReviewStageFilterByCurrentUserOptions values +### accessReviewStageFilterByCurrentUserOptions values | Member | | | | reviewer | | unknownFutureValue | -## continuousAccessEvaluationMode values +### continuousAccessEvaluationMode values | Member | | | Namespace: microsoft.graph | unknownFutureValue | | strictLocation | -## msiType values +### msiType values | Member | | | Namespace: microsoft.graph | systemAssigned | | unknownFutureValue | -## multiFactorAuthConfiguration values +### multiFactorAuthConfiguration values | Member | Value | Description | | | -- | - | Namespace: microsoft.graph | required | 1 | Multifactor authentication is required for a user to complete device registration. | | unknownFutureValue | 2 | Evolvable enumeration sentinel value. Don't use. | -## policyScope values +### policyScope values | Member | Value | Description | | | -- | | Namespace: microsoft.graph | selected | 2 | The policy applies to specific users or groups in the organization. | | unknownFutureValue | 3 | Evolvable enumeration sentinel value. Don't use. | -## appManagementRestrictionState values +### appManagementRestrictionState values | Member | | - | Namespace: microsoft.graph | disabled | | unknownFutureValue | -## appCredentialRestrictionType values +### appCredentialRestrictionType values | Member | | - | Namespace: microsoft.graph | customPasswordAddition | | unknownFutureValue | -## appKeyCredentialRestrictionType values +### appKeyCredentialRestrictionType values | Member | | | Namespace: microsoft.graph | trustedCertificateAuthority | | unknownFutureValue | -## synchronizationSecret values +### synchronizationSecret values | Member | | - | Namespace: microsoft.graph | TestReferences | | ConnectionString | -## synchronizationScheduleState values +### synchronizationScheduleState values | Member | | -- | Namespace: microsoft.graph | Disabled | | Paused | -## synchronizationStatusCode values +### synchronizationStatusCode values | Member | | - | Namespace: microsoft.graph | Paused | | Quarantine | -## synchronizationTaskExecutionResult values +### synchronizationTaskExecutionResult values | Member | | - | Namespace: microsoft.graph | Failed | | EntryLevelErrors | -## quarantineReason values +### quarantineReason values | Member | | | Namespace: microsoft.graph | TooManyDeletes | | IngestionInterrupted | -## attributeMappingSourceType values +### attributeMappingSourceType values | Member | | | Namespace: microsoft.graph | Constant | | Function | -## filterMode values +### filterMode values | Member | | - | | include | | exclude | -## lifecycleEventType values +### lifecycleEventType values | Member | | -- | Namespace: microsoft.graph | subscriptionRemoved | | reauthorizationRequired | -## changeType values +### changeType values | Member | | - | Namespace: microsoft.graph | updated | | deleted | -## countryLookupMethodType values +### countryLookupMethodType values | Member | | - | | clientIpAddress | | authenticatorAppGps | -## approvalState values +### approvalState values | Member | | -- | Namespace: microsoft.graph | aborted | | canceled | -## roleSummaryStatus values +### roleSummaryStatus values | Member | | | | ok | | bad | -## dataPolicyOperationStatus values +### dataPolicyOperationStatus values | Member | | | Namespace: microsoft.graph | failed | | unknownFutureValue | -## conditionalAccessClientApp values +### conditionalAccessClientApp values | Member | | | Namespace: microsoft.graph | easSupported | | other | -## consentRequestFilterByCurrentUserOptions values +### consentRequestFilterByCurrentUserOptions values | Member | | | | reviewer | | unknownFutureValue | -## attributeType values +### attributeType values | Member | | | Namespace: microsoft.graph | Boolean | | DateTime | -## scopeOperatorType values +### scopeOperatorType values | Member | | | | Binary | | Unary | -## synchronizationJobRestartScope values +### synchronizationJobRestartScope values | Member | | - | Namespace: microsoft.graph | Full | | ForceDeletes | -## synchronizationMetadata values +### synchronizationMetadata values | Member | | - | Namespace: microsoft.graph | SynchronizationLearnMoreIbizaFwLink | | ConfigurationFields | -## mutability values +### mutability values | Member | | | Namespace: microsoft.graph | Immutable | | WriteOnly | -## directoryDefinitionDiscoverabilities values +### directoryDefinitionDiscoverabilities values | Member | | - | Namespace: microsoft.graph | ReferenceAttributes | | UnknownFutureValue | -## objectDefinitionMetadata values +### objectDefinitionMetadata values | Member | | - | Namespace: microsoft.graph | Extensions | | BaseObjectName | -## connectorGroupRegion values +### connectorGroupRegion values | Member | | | Namespace: microsoft.graph | ind | | unknownFutureValue | -## connectorGroupType values +### connectorGroupType values | Member | | - | | applicationProxy | -## onPremisesPublishingType values +### onPremisesPublishingType values | Member | | | Namespace: microsoft.graph | oflineDomainJoin | | unknownFutureValue | -## agentStatus values +### agentStatus values | Member | | -- | | active | | inactive | -## connectorStatus values +### connectorStatus values | Member | | -- | | active | | inactive | -## callType values +### callType values | Member | | | Namespace: microsoft.graph | peerToPeer | | unknownFutureValue | -## tone values +### tone values | Member | | | Namespace: microsoft.graph | d | | flash | -## callState values +### callState values | Member | | - | Namespace: microsoft.graph | terminating | | terminated | -## routingPolicy values +### routingPolicy values | Member | | - | Namespace: microsoft.graph | preferSkypeForBusiness | | unknownFutureValue | -## meetingCapabilities values +### meetingCapabilities values | Member | | | | questionAndAnswer | | unknownFutureValue | -## onlineMeetingRole values +### onlineMeetingRole values | Member | | | Namespace: microsoft.graph | producer | | unknownFutureValue | -## autoAdmittedUsersType values +### autoAdmittedUsersType values | Member | | -- | | everyoneInCompany | | everyone | -## mediaState values +### mediaState values | Member | | | Namespace: microsoft.graph | inactive | | unknownFutureValue | -## callDirection values +### callDirection values | Member | | -- | | incoming | | outgoing | -## modality values +### modality values | Member | | -- | Namespace: microsoft.graph | screenSharing | | unknownFutureValue | -## endpointType values +### endpointType values | Member | | - | Namespace: microsoft.graph | skypeForBusinessVoipPhone | | unknownFutureValue | -## kerberosSignOnMappingAttributeType values +### kerberosSignOnMappingAttributeType values | Member | | - | Namespace: microsoft.graph | onPremisesUserPrincipalUsername | | onPremisesSAMAccountName | -## externalAuthenticationType values +### externalAuthenticationType values | Member | | -- | | passthru | | aadPreAuthentication | -## recipientScopeType values +### recipientScopeType values | Member | | | Namespace: microsoft.graph | externalPartner | | externalNonPartner | -## appliedConditionalAccessPolicyResult values +### appliedConditionalAccessPolicyResult values | Member | | | Namespace: microsoft.graph | reportOnlyNotApplied | | reportOnlyInterrupted | -## microsoftAuthenticatorAuthenticationMode values +### microsoftAuthenticatorAuthenticationMode values | Member | | | Namespace: microsoft.graph | push | | deviceBasedPush | -## authenticationMethodFeature values +### authenticationMethodFeature values | Member | | - | Namespace: microsoft.graph | passwordlessCapable | | mfaCapable | -## authMethodsType values +### authMethodsType values | Member | | - | Namespace: microsoft.graph | mobilePhoneAndSMS | | unknownFutureValue | -## defaultMfaMethodType values +### defaultMfaMethodType values | Member | | -- | Namespace: microsoft.graph | softwareOneTimePasscode | | unknownFutureValue | -## clientCredentialType values +### clientCredentialType values | Member | | | Namespace: microsoft.graph | certificate | | unknownFutureValue | -## azureADLicenseType values +### azureADLicenseType values | Member | | | Namespace: microsoft.graph | premiumP2 | | unknownFutureValue | -## conditionalAccessConditions values +### conditionalAccessConditions values | Member | | - | Namespace: microsoft.graph | authenticationFlows | | insiderRisk | -## conditionalAccessStatus values +### conditionalAccessStatus values | Member | | | Namespace: microsoft.graph | notApplied | | unknownFutureValue | -## featureType values +### featureType values | Member | | | Namespace: microsoft.graph | reset | | unknownFutureValue | -## groupType values +### groupType values | Member | | | Namespace: microsoft.graph | azureAD | | unknownFutureValue | -## includedUserRoles values +### includedUserRoles values | Member | | | Namespace: microsoft.graph | user | | unknownFutureValue | -## includedUserTypes values +### includedUserTypes values | Member | | | Namespace: microsoft.graph | guest | | unknownFutureValue | -## initiatorType values +### initiatorType values | Member | | | Namespace: microsoft.graph | system | | unknownFutureValue | -## migrationStatus values +### migrationStatus values | Member | | -- | Namespace: microsoft.graph | additionalStepsRequired | | unknownFutureValue | -## networkType values +### networkType values | Member | | | Namespace: microsoft.graph | trusted | | unknownFutureValue | -## operationResult values +### operationResult values | Member | | | Namespace: microsoft.graph | timeout | | unknownFutureValue | -## provisioningResult values +### provisioningResult values | Member | | | Namespace: microsoft.graph | warning | | unknownFutureValue | -## provisioningStepType values +### provisioningStepType values | Member | | - | Namespace: microsoft.graph | export | | unknownFutureValue | -## registrationAuthMethod values +### registrationAuthMethod values | Member | | -- | Namespace: microsoft.graph | appPassword | | unknownFutureValue | -## registrationStatusType values +### registrationStatusType values | Member | | | Namespace: microsoft.graph | mfaRegistered | | unknownFutureValue | -## signInIdentifierType values +### signInIdentifierType values | Member | | | Namespace: microsoft.graph | onPremisesUserPrincipalName | | unknownFutureValue | -## signInUserType values +### signInUserType values | Member | | | Namespace: microsoft.graph | guest | | unknownFutureValue | -## requirementProvider values +### requirementProvider values | Member | | - | Namespace: microsoft.graph | scopeBasedAuthRequirementPolicy | | authenticationStrengths | -## riskDetail values +### riskDetail values | Member | | -- | Namespace: microsoft.graph | adminConfirmedAccountSafe | <!-- maintenance comment: Do not delete enum delcaration for riskEventType until all properties of this type are marked as deleted. Dec 28, 2021: Pending eventTypes (in riskUserActivity) and riskType (in riskDetection)-->-## riskEventType values +### riskEventType values | Member | | -- | Namespace: microsoft.graph | maliciousIPAddressValidCredentialsBlockedIP | | unknownFutureValue | -## usageAuthMethod values +### usageAuthMethod values | Member | | - | Namespace: microsoft.graph | appPassword | | unknownFutureValue | -## authenticationAppAdminConfiguration values +### authenticationAppAdminConfiguration values | Member | | | Namespace: microsoft.graph | disabled | | unknownFutureValue | -## authenticationAppEvaluation values +### authenticationAppEvaluation values | Member | | | Namespace: microsoft.graph | failure | | unknownFutureValue | -## authenticationAppPolicyStatus values +### authenticationAppPolicyStatus values | Member | | | Namespace: microsoft.graph | tamperResistantHardwareNotUsed | | unknownFutureValue | -## authenticationMethodKeyStrength values +### authenticationMethodKeyStrength values | Member | | - | Namespace: microsoft.graph | weak | | unknown | -## authenticationMethodPlatform values +### authenticationMethodPlatform values | Member | | - | Namespace: microsoft.graph | linux | | unknown | -## authenticationContextDetail values +### authenticationContextDetail values | Member | | - | Namespace: microsoft.graph | notApplicable | | unknownFutureValue | -## educationAddedStudentAction values +### educationAddedStudentAction values | Member | | | Namespace: microsoft.graph | assignIfOpen | | unknownFutureValue | -## educationAddToCalendarOptions values +### educationAddToCalendarOptions values | Member | | | Namespace: microsoft.graph | unknownFutureValue | | studentsOnly | -## educationModuleStatus values +### educationModuleStatus values | Member | | | | draft | | published | -## educationAssignmentStatus values +### educationAssignmentStatus values | Member | | | Namespace: microsoft.graph | unknownFutureValue | | inactive | -## educationSubmissionStatus values +### educationSubmissionStatus values | Member | | - | Namespace: microsoft.graph | reassigned | | excused | -## educationFeedbackResourceOutcomeStatus values +### educationFeedbackResourceOutcomeStatus values | Member | | | Namespace: microsoft.graph | failedPublish | | unknownFutureValue | -## externalEmailOtpState values +### externalEmailOtpState values | Member | | | Namespace: microsoft.graph | disabled | | unknownFutureValue | -## expirationRequirement values +### expirationRequirement values | Member | | - | Namespace: microsoft.graph | signInFrequencyEveryTime | | unknownFutureValue | -## replyRestriction values +### replyRestriction values | Member | | | Namespace: microsoft.graph | authorAndModerators | | unknownFutureValue | -## userNewMessageRestriction values +### userNewMessageRestriction values | Member | | | Namespace: microsoft.graph | moderators | | unknownFutureValue | -## volumeType values +### volumeType values | Member | | | Namespace: microsoft.graph | removableDataVolume | | unknownFutureValue | -## allowedAudiences values +### allowedAudiences values | Member | | - | Namespace: microsoft.graph | everyone | | unknownFutureValue | -## attestationLevel values +### attestationLevel values | Member | | | Namespace: microsoft.graph | notAttested | | unknownFutureValue | -## emailType values +### emailType values | Member | | -- | Namespace: microsoft.graph | main | | other | -## authenticationMethodSignInState values +### authenticationMethodSignInState values | Member | | -- | Namespace: microsoft.graph | notConfigured | | unknownFutureValue | -## authenticationPhoneType values +### authenticationPhoneType values | Member | | | Namespace: microsoft.graph | office | | unknownFutureValue | -## authenticationMethodTargetType values +### authenticationMethodTargetType values | Member | | | Namespace: microsoft.graph | group | | unknownFutureValue | -## authenticationMethodState values +### authenticationMethodState values | Member | | -- | | enabled | | disabled | -## fido2RestrictionEnforcementType values +### fido2RestrictionEnforcementType values | Member | | | Namespace: microsoft.graph | block | | unknownFutureValue | -## x509CertificateAuthenticationMode values +### x509CertificateAuthenticationMode values | Member | | | Namespace: microsoft.graph | x509CertificateMultiFactor | | unknownFutureValue | -## x509CertificateAffinityLevel values +### x509CertificateAffinityLevel values | Member | | | Namespace: microsoft.graph | high | | unknownFutureValue | -## x509CertificateRuleType values +### x509CertificateRuleType values | Member | | - | Namespace: microsoft.graph | unknownFutureValue | | issuerSubjectAndPolicyOID | -## x509CertificateIssuerHintsState values +### x509CertificateIssuerHintsState values | Member | | - | Namespace: microsoft.graph | enabled | | unknownFutureValue | -## anniversaryType values +### anniversaryType values | Member | | | Namespace: microsoft.graph | wedding | | unknownFutureValue | -## skillProficiencyLevel values +### skillProficiencyLevel values | Member | | -- | Namespace: microsoft.graph | expert | | unknownFutureValue | -## languageProficiencyLevel values +### languageProficiencyLevel values | Member | | - | Namespace: microsoft.graph | nativeOrBilingual | | unknownFutureValue | -## personRelationship values +### personRelationship values | Member | | | Namespace: microsoft.graph | other | | unknownFutureValue | -## attachmentType values +### attachmentType values | Member | | | Namespace: microsoft.graph | item | | reference | -## analyticsActivityType values +### analyticsActivityType values | Member | | | Namespace: microsoft.graph | focus | | meeting | -## entityTypes values +### entityTypes values | Member | | | Namespace: microsoft.graph | qna | | unknownFutureValue | -## searchAlterationType values +### searchAlterationType values | Member | | | | modification | | suggestion | -## bucketAggregationSortProperty values +### bucketAggregationSortProperty values | Member | | -- | Namespace: microsoft.graph | keyAsString | | keyAsNumber | -## contactRelationship values +### contactRelationship values | Member | Value | Description | | | -- | - | Namespace: microsoft.graph | other | 6 | An unspecified relationship to the user. | | unknownFutureValue | 7 | Marker value for future compatibility. | -## scheduleEntityTheme values +### scheduleEntityTheme values | Member | | -- | Namespace: microsoft.graph | darkYellow | | unknownFutureValue | -## timeOffReasonIconType values +### timeOffReasonIconType values | Member | | | Namespace: microsoft.graph | sunny | | unknownFutureValue | -## timeCardState values +### timeCardState values | Member | | | Namespace: microsoft.graph | clockedOut | | unknownFutureValue | -## scheduleChangeState values +### scheduleChangeState values | Member | | -- | Namespace: microsoft.graph | declined | | unknownFutureValue | -## scheduleChangeRequestActor values +### scheduleChangeRequestActor values | Member | | -- | Namespace: microsoft.graph | system | | unknownFutureValue | -## windowsSettingType values +### windowsSettingType values | Member | | | Namespace: microsoft.graph | backup | | unknownFutureValue | -## workforceIntegrationEncryptionProtocol values +### workforceIntegrationEncryptionProtocol values | Member | | -- | | sharedSecret | | unknownFutureValue | -## workforceIntegrationSupportedEntities values +### workforceIntegrationSupportedEntities values | Member | | -- | Namespace: microsoft.graph | timeOff | | timeOffRequest | -## confirmedBy values +### confirmedBy values | Member | | | Namespace: microsoft.graph | manager | | unknownFutureValue | -## timeZoneStandard values +### timeZoneStandard values | Member | | | | windows | | iana | -## freeBusyStatus values +### freeBusyStatus values | Member | Value | | - | -- | Namespace: microsoft.graph | workingElsewhere | 4 | | unknown | -1 | -## physicalAddressType values +### physicalAddressType values | Member | | -- | Namespace: microsoft.graph | business | | other | -## attendeeType values +### attendeeType values | Member | | -- | Namespace: microsoft.graph | optional | | resource | -## externalAudienceScope values +### externalAudienceScope values | Member | | -- | Namespace: microsoft.graph | contactsOnly | | all | -## automaticRepliesStatus values +### automaticRepliesStatus values | Member | | -- | Namespace: microsoft.graph | alwaysEnabled | | scheduled | -## calendarColor values +### calendarColor values | Member | Value | | -- | -- | Namespace: microsoft.graph | lightRed | 8 | | maxColor | 9 | -## educationSynchronizationProfileState values +### educationSynchronizationProfileState values | Member | Value | | | -- | Namespace: microsoft.graph | provisioning | 7 | | unknownFutureValue | 8 | -## educationSynchronizationStatus values +### educationSynchronizationStatus values | Member | | | Namespace: microsoft.graph | extracting | | validating | -## educationExternalSource values +### educationExternalSource values | Member | | -- | Namespace: microsoft.graph | manual | | unknownFutureValue | -## educationGender values +### educationGender values | Member | | -- | Namespace: microsoft.graph | other | | unknownFutureValue | -## eventType values +### eventType values | Member | | -- | Namespace: microsoft.graph | exception | | seriesMaster | -## sensitivity values +### sensitivity values | Member | | -- | Namespace: microsoft.graph | private | | confidential | -## importance values +### importance values | Member | | -- | Namespace: microsoft.graph | normal | | high | -## educationUserRole values +### educationUserRole values | Member | | - | Namespace: microsoft.graph | teacher | | faculty | -## meetingMessageType values +### meetingMessageType values | Member | | | Namespace: microsoft.graph | meetingTentativelyAccepted | | meetingDeclined | -## followupFlagStatus values +### followupFlagStatus values | Member | | -- | Namespace: microsoft.graph | complete | | flagged | -## inferenceClassificationType values +### inferenceClassificationType values | Member | | | | focused | | other | -## iosNotificationAlertType values +### iosNotificationAlertType values | Member | | -- | Namespace: microsoft.graph | modal | | none | -## deviceEnrollmentFailureReason values +### deviceEnrollmentFailureReason values | Member | | -- | Namespace: microsoft.graph | enrollmentRestrictionsEnforced | | clientDisconnected | -## bodyType values +### bodyType values | Member | | - | | text | | html | -## locationType values +### locationType values | Member | | -- | Namespace: microsoft.graph | localBusiness | | postalAddress | -## locationUniqueIdType values +### locationUniqueIdType values | Member | | -- | Namespace: microsoft.graph | private | | bing | -## messageActionFlag values +### messageActionFlag values | Member | | -- | Namespace: microsoft.graph | replyToAll | | review | -## onenoteUserRole values +### onenoteUserRole values | Member | Value | | -- | -- | Namespace: microsoft.graph | Reader | 2 | | None | -1 | -## operationStatus values +### operationStatus values | Member | | | Namespace: microsoft.graph | Completed | | Failed | -## onenotePatchActionType values +### onenotePatchActionType values | Member | | -- | Namespace: microsoft.graph | Insert | | Prepend | -## onenotePatchInsertPosition values +### onenotePatchInsertPosition values | Member | | -- | | After | | Before | -## phoneType values +### phoneType values | Member | | -- | Namespace: microsoft.graph | pager | | radio | -## plannerPreviewType values +### plannerPreviewType values | Member | | -- | Namespace: microsoft.graph | description | | reference | -## status values +### status values | Member | | | Namespace: microsoft.graph | ignored | | unknownFutureValue | -## weekIndex values +### weekIndex values | Member | | -- | Namespace: microsoft.graph | fourth | | last | -## dayOfWeek values +### dayOfWeek values | Member | | -- | Namespace: microsoft.graph | friday | | saturday | -## recurrencePatternType values +### recurrencePatternType values | Member | | -- | Namespace: microsoft.graph | absoluteYearly | | relativeYearly | -## recurrenceRangeType values +### recurrenceRangeType values | Member | | -- | Namespace: microsoft.graph | noEnd | | numbered | -## onenoteSourceService values +### onenoteSourceService values | Member | | - | Namespace: microsoft.graph | OneDriveForBusiness | | OnPremOneDriveForBusiness | -## responseType values +### responseType values | Member | | -- | Namespace: microsoft.graph | declined | | notResponded | -## activityDomain values +### activityDomain values | Member | | -- | Namespace: microsoft.graph | personal | | unrestricted | -## websiteType values +### websiteType values | Member | | -- | Namespace: microsoft.graph | blog | | profile | -## categoryColor values +### categoryColor values | Member | Value | | -- | -- | Namespace: microsoft.graph | preset23 | 23 | | preset24 | 24 | -## alertFeedback values +### alertFeedback values Possible feedback values on the alert provided by an analyst. Possible feedback values on the alert provided by an analyst. | falsePositive | 2 | Alert is false-positive. | | benignPositive | 3 | Alert is benign-positive. | -## fileHashType values +### fileHashType values | Member | Value | Description | | - | -- | | Possible feedback values on the alert provided by an analyst. | peSha1 | 7 | PESHA1 hash type. | | peSha256 | 8 | PESHA256 hash type. | -## connectionDirection values +### connectionDirection values | Member | Value | Description | | -- | -- | -- | Possible feedback values on the alert provided by an analyst. | inbound | 1 | Inbound connection. | | outbound | 2 | Outbound connection. | -## connectionStatus values +### connectionStatus values | Member | Value | Description | | | -- | -- | Possible feedback values on the alert provided by an analyst. | blocked | 3 | Connection blocked. | | failed | 4 | Connection failed. | -## processIntegrityLevel values +### processIntegrityLevel values | Member | Value | Description | | | -- | -- | Possible feedback values on the alert provided by an analyst. | high | 40 | Integrity level is High. | | system | 50 | Integrity level is System. | -## registryHive values +### registryHive values Enum for registry hives as defined by [Registry Hives](/windows/desktop/sysinfo/registry-hives). Enum for registry hives as defined by [Registry Hives](/windows/desktop/sysinfo/ | localMachineSystem | 5 | HKEY_LOCAL_MACHINE\System hive. | | usersDefault | 6 | HKEY_USERS\\.DEFAULT hive. | -## registryOperation values +### registryOperation values Operation that changed the registry key name and/or value. Operation that changed the registry key name and/or value. | modify | 2 | Modify registry. | | delete | 3 | Delete registry. | -## registryValueType values +### registryValueType values Enum for registry value types as defined by [Registry value types](/windows/desktop/sysinfo/registry-value-types). Enum for registry value types as defined by [Registry value types](/windows/desk | qwordlittleEndian | 10 | REG_QWORD_LITTLE_ENDIAN registry value type. | | sz | 11 | REG_SZ registry value type. | -## alertSeverity values +### alertSeverity values Enum for severity of alerts. Enum for severity of alerts. | medium | 3 | Severity is medium. | | high | 4 | Severity is high. | -## alertStatus values +### alertStatus values Possible values of an Alert lifecycle status (stage). Possible values of an Alert lifecycle status (stage). | inProgress | 20 | Alert is in progress. | | resolved | 30 | Alert is resolved. | -## emailRole values +### emailRole values Possible values for email roles. Possible values for email roles. | sender | 1 | Sender of the email. | | recipient | 2 | Recipient of the email. | -## logonType values +### logonType values Possible values for the method of user signin. Possible values for the method of user signin. | batch | 3 | Logon is batch. | | service | 4 | Logon is service. | -## userAccountSecurityType values +### userAccountSecurityType values Possible values for user account types (group membership), per Windows definition. Possible values for user account types (group membership), per Windows definitio | power | 1 | Member of Power Users group. | | administrator | 2 | Member of Administrators group. | -## chatMessagePolicyViolationDlpActionType values +### chatMessagePolicyViolationDlpActionType values | Value | | - | Possible values for user account types (group membership), per Windows definitio | BlockAccess | | BlockAccessExternal | -## scopeOperatorMultiValuedComparisonType values +### scopeOperatorMultiValuedComparisonType values | Member | | - | | All | | Any | -## riskLevel values +### riskLevel values | Member | | | Possible values for user account types (group membership), per Windows definitio | none | | unknownFutureValue | -## riskState values +### riskState values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | confirmedCompromised | | unknownFutureValue | -## advancedConfigState values +### advancedConfigState values | Member | | | Possible values for user account types (group membership), per Windows definitio | disabled | | unknownFutureValue | -## referenceAttachmentPermission values +### referenceAttachmentPermission values | Member | | - | Possible values for user account types (group membership), per Windows definitio | organizationView | | organizationEdit | -## referenceAttachmentProvider values +### referenceAttachmentProvider values | Member | | - | Possible values for user account types (group membership), per Windows definitio | oneDriveConsumer | | dropbox | -## exchangeIdFormat values +### exchangeIdFormat values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | restId | | restImmutableEntryId | -## attributeDefinitionMetadata values +### attributeDefinitionMetadata values | Member | | - | Possible values for user account types (group membership), per Windows definitio | MaximumLength | | ReferencedProperty | -## attributeFlowBehavior values +### attributeFlowBehavior values | Member | | - | | FlowWhenChanged | | FlowAlways | -## attributeFlowType values +### attributeFlowType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | ValueAddOnly | | AttributeAddOnly | -## objectFlowTypes values +### objectFlowTypes values | Member | | - | Possible values for user account types (group membership), per Windows definitio | Update | | Delete | -## objectMappingMetadata values +### objectMappingMetadata values | Member | | - | Possible values for user account types (group membership), per Windows definitio | ExcludeFromReporting | | Unsynchronized | -## chatMessageType values +### chatMessageType values | Member | | | Possible values for user account types (group membership), per Windows definitio | unknownFutureValue | | systemEventMessage | -## chatMessageImportance values +### chatMessageImportance values | Member | | | Possible values for user account types (group membership), per Windows definitio | high | | urgent | -## stagedFeatureName values +### stagedFeatureName values | Member | | - | Possible values for user account types (group membership), per Windows definitio | unknownFutureValue | | certificateBasedAuthentication | -## tokenIssuerType values +### tokenIssuerType values | Member | | | Possible values for user account types (group membership), per Windows definitio | ADFederationServicesMFAAdapter | | NPSExtension | -## riskDetectionTimingType values +### riskDetectionTimingType values | Member | | | Possible values for user account types (group membership), per Windows definitio | offline | | unknownFutureValue | -## activityType values +### activityType values | Member | | | Possible values for user account types (group membership), per Windows definitio | unknownFutureValue | | servicePrincipal | -## chatMessagePolicyViolationUserActionType values +### chatMessagePolicyViolationUserActionType values | Member | Int value | Description | | - | | | Possible values for user account types (group membership), per Windows definitio | Override | 1 | Sender has overridden the message verdict and sent the message anyway. | | ReportFalsePositive | 2 | Sender has reported the message verdict to the admins as a false positive. | -## chatMessagePolicyViolationVerdictDetailsType values +### chatMessagePolicyViolationVerdictDetailsType values | Member | Int value | Description | | | | | Possible values for user account types (group membership), per Windows definitio | AllowOverrideWithoutJustification | 2 | User is allowed to override the block and send the message. Justification text isn't required. Exclusive to `AllowOverrideWithJustification`. | | AllowOverrideWithJustification | 4 | User is allowed to override the block and send the message. Justification text is required. Exclusive to `AllowOverrideWithoutJustification`. | -## entityType values +### entityType values | Member | | | Possible values for user account types (group membership), per Windows definitio | externalFile | | externalItem | -## onlineMeetingProviderType values +### onlineMeetingProviderType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | skypeForConsumer | | teamsForBusiness | -## delegateMeetingMessageDeliveryOptions values +### delegateMeetingMessageDeliveryOptions values | Member | | | Possible values for user account types (group membership), per Windows definitio | sendToDelegateAndPrincipal | | sendToDelegateOnly | -## calendarRoleType values +### calendarRoleType values | Member | | | Possible values for user account types (group membership), per Windows definitio | delegateWithPrivateEventAccess | | custom | -## contentFormat values +### contentFormat values | Member | Value | Description | | - | -- | | | default | 0 | Content is a file or non-email type. | | email | 1 | Content is an email. | -## contentState values +### contentState values | Member | Value | Description | | | -- | -- | Possible values for user account types (group membership), per Windows definitio | motion | 1 | Data is in motion. A file intercepted by a network appliance in transit. | | use | 2 | Data is in use. A file is open in a client application such as Microsoft Office. | -## assignmentMethod values +### assignmentMethod values | Member | Value | Description | | - | -- | -- | Possible values for user account types (group membership), per Windows definitio | privileged | 1 | The label was set explicitly by a user. | | auto | 2 | Allows override of any existing label. Justification required on downgrade. Results in `standard` assignment method in metadata. | -## actionSource values +### actionSource values | Member | Value | Description | | - | -- | | Possible values for user account types (group membership), per Windows definitio | policyDefault | 3 | The user no action and the policy-default label was applied. | | mandatory | 4 | The user chose a label after being forced to choose. | -## contentAlignment values +### contentAlignment values | Member | Value | Description | | | -- | -- | Possible values for user account types (group membership), per Windows definitio | right | 1 | Align content marking to the right. | | center | 2 | Center content marking. | -## watermarkLayout values +### watermarkLayout values | Member | Value | Description | | - | -- | | | horizontal | 0 | Use a horizontal watermark. | | diagonal | 1 | Use a diagonal watermark. | -## conditionalAccessPolicyState values +### conditionalAccessPolicyState values | Member | | | Possible values for user account types (group membership), per Windows definitio | disabled | | enabledForReportingButNotEnforced | -## conditionalAccessGrantControl values +### conditionalAccessGrantControl values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | passwordChange | | unknownFutureValue | -## perUserMfaState values +### perUserMfaState values | Member | | - | Possible values for user account types (group membership), per Windows definitio | enabled | | unknownFutureValue | -## conditionalAccessRule values +### conditionalAccessRule values | Member | | | Possible values for user account types (group membership), per Windows definitio | authenticationTransfer | | insiderRisk | -## signInAccessType values +### signInAccessType values | Member | | | Possible values for user account types (group membership), per Windows definitio | unknownFutureValue | | passthrough | -## signinFrequencyType values +### signinFrequencyType values | Member | | | | days | | hours | -## originalTransferMethods values +### originalTransferMethods values | Member | | - | Possible values for user account types (group membership), per Windows definitio | authenticationTransfer | | unknownFutureValue | -## tokenProtectionStatus values +### tokenProtectionStatus values | Member | | - | Possible values for user account types (group membership), per Windows definitio | unbound | | unknownFutureValue | -## conditionalAccessAudienceReason values +### conditionalAccessAudienceReason values | Member | | | Possible values for user account types (group membership), per Windows definitio | thirdPartyResourceDefault | | unknownFutureValue | -## persistentBrowserSessionMode values +### persistentBrowserSessionMode values | Member | | | | always | | never | -## cloudAppSecuritySessionControlType values +### cloudAppSecuritySessionControlType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | monitorOnly | | blockDownloads | -## conditionalAccessDevicePlatform values +### conditionalAccessDevicePlatform values | Member | | | Possible values for user account types (group membership), per Windows definitio | all | | unknownFutureValue | -## priority values +### priority values | Member | Value | | | -- | Possible values for user account types (group membership), per Windows definitio | High | 1 | | Low | 2 | -## templateScenarios values +### templateScenarios values | Member | | | Possible values for user account types (group membership), per Windows definitio | emergingThreats | | unknownFutureValue | -## threatAssessmentContentType values +### threatAssessmentContentType values | Member | Value | Description | | | -- | -- | Possible values for user account types (group membership), per Windows definitio | url | 2 | URL threat. | | file | 3 | Attachment file threat. | -## threatExpectedAssessment values +### threatExpectedAssessment values | Member | Value | Description | | - | -- | -- | | block | 1 | The threat should be blocked. | | unblock | 2 | The threat shouldn't be blocked. | -## threatCategory values +### threatCategory values | Member | Value | Description | | | -- | | Possible values for user account types (group membership), per Windows definitio | malware | 3 | Malware threat. | | unknownFutureValue | 4 | A sentinel member. | -## threatAssessmentStatus values +### threatAssessmentStatus values | Member | Value | Description | | | -- | - | | pending | 1 | The threat assessment still in progress. | | completed | 2 | The threat assessment completed. | -## threatAssessmentRequestSource values +### threatAssessmentRequestSource values | Member | Value | Description | | - | -- | | Possible values for user account types (group membership), per Windows definitio | user | 1 | User submission. | | administrator | 2 | Tenant admin submission. | -## threatAssessmentResultType values +### threatAssessmentResultType values | Member | Value | Description | | | -- | - | Possible values for user account types (group membership), per Windows definitio | rescan | 2 | The rescan result. | | unknownFutureValue | 3 | A sentinel member. | -## mailDestinationRoutingReason values +### mailDestinationRoutingReason values | Member | Value | Description | | | -- | -- | Possible values for user account types (group membership), per Windows definitio | junk | 14 | Blocked due to junk. | | unknownFutureValue | 15 | A sentinel member. | -## threatAssessmentRequestPivotProperty values +### threatAssessmentRequestPivotProperty values | Member | Value | Description | | - | -- | - | | threatCategory | 1 | Aggregate threat assessment request by `threatCategory`. | | mailDestinationRoutingReason | 2 | Aggregate threat assessment request by `mailDestinationRoutingReason`. | -## userFlowType values +### userFlowType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | resourceOwner | | unknownFutureValue | -## openIdConnectResponseMode values +### openIdConnectResponseMode values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | query | | unknownFutureValue | -## wellknownListName values +### wellknownListName values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | flaggedEmails | | unknownFutureValue | -## taskStatus values +### taskStatus values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | waitingOnOthers | | deferred | -## columnTypes values +### columnTypes values | Member | Description | | | -- | Possible values for user account types (group membership), per Windows definitio | approvalStatus | Content approval status column. | | unknownFutureValue | unknownFuturevalue | -## contentModelType values +### contentModelType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | prebuiltReceiptModel | | unknownFutureValue | -## documentProcessingJobStatus values +### documentProcessingJobStatus values | Member | | - | Possible values for user account types (group membership), per Windows definitio | failed | | unknownFutureValue | -## documentProcessingJobType values +### documentProcessingJobType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | Folder | | UnknownFutureValue | -## connectedOrganizationState values +### connectedOrganizationState values | Member | Value | Description | | | -- | - | Possible values for user account types (group membership), per Windows definitio | proposed | 1 | Connected Organizations that are automatically created by the system have this state value. They aren't included in assignment policies with requestor scope type `AllConfiguredConnectedOrganizationSubjects`. | | unknownFutureValue | 2 | A sentinel member. | -## identityUserFlowAttributeDataType values +### identityUserFlowAttributeDataType values | Member | Value | Description | | | -- | | Possible values for user account types (group membership), per Windows definitio | dateTime | 5 | | | unknownFutureValue | 6 | A sentinel member. | -## identityUserFlowAttributeType values +### identityUserFlowAttributeType values | Member | Value | Description | | | -- | | Possible values for user account types (group membership), per Windows definitio | required | 3 | | | unknownFutureValue | 4 | A sentinel member. | -## permissionClassificationType values +### permissionClassificationType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | medium | | high | -## permissionType values +### permissionType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | delegated | | delegatedUserConsentable | -## identityUserFlowAttributeInputType values +### identityUserFlowAttributeInputType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | emailBox | | checkboxMultiSelect | -## teamworkActivityTopicSource values +### teamworkActivityTopicSource values | Member | | - | | entityUrl | | text | -## cloudPcProvisioningPolicyImageType values +### cloudPcProvisioningPolicyImageType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | gallery | | unknownFutureValue | -## cloudPcPolicySettingType values +### cloudPcPolicySettingType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | singleSignOn | | unknownFutureValue | -## chatType values +### chatType values | Member | Value | Description | | | -- | -- | Possible values for user account types (group membership), per Windows definitio | meeting | 2 | Indicates that the chat is a Meeting chat, which is created as a side effect of creation of an OnlineMeeting. | | unknownFutureValue | 3 | Sentinel value to indicate future values. | -## singleSignOnMode values +### singleSignOnMode values | Member | | | Possible values for user account types (group membership), per Windows definitio | aadHeaderBased | | pingHeaderBased | -## plannerContainerType values +### plannerContainerType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | driveItem | | user | -## plannerPlanContextType values +### plannerPlanContextType values | Member | | | Possible values for user account types (group membership), per Windows definitio | other | | unknownFutureValue | -## plannerContextState values +### plannerContextState values | Member | | | Possible values for user account types (group membership), per Windows definitio | delinked | | unknownFutureValue | -## plannerExternalTaskSourceDisplayType values +### plannerExternalTaskSourceDisplayType values | Member | | | Possible values for user account types (group membership), per Windows definitio | default | | unknownFutureValue | -## plannerCreationSourceKind values +### plannerCreationSourceKind values | Member | | | Possible values for user account types (group membership), per Windows definitio | publication | | unknownFutureValue | -## teamsAppInstallationScope values +### teamsAppInstallationScope values | Member | Value | Description | | | -- | | Possible values for user account types (group membership), per Windows definitio | groupChat | 1 | Indicates that the Teams app can be installed within a group chat and is authorized to access that group chat's data. | | personal | 2 | Indicates that the Teams app can be installed in the personal scope of a user and is authorized to access that user's data. | -## assignmentScheduleFilterByCurrentUserOptions values +### assignmentScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## assignmentScheduleInstanceFilterByCurrentUserOptions values +### assignmentScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## assignmentScheduleRequestFilterByCurrentUserOptions values +### assignmentScheduleRequestFilterByCurrentUserOptions values | Member | | | Possible values for user account types (group membership), per Windows definitio | approver | | unknownFutureValue | -## eligibilityScheduleFilterByCurrentUserOptions values +### eligibilityScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## eligibilityScheduleInstanceFilterByCurrentUserOptions values +### eligibilityScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## eligibilityScheduleRequestFilterByCurrentUserOptions values +### eligibilityScheduleRequestFilterByCurrentUserOptions values | Member | | | Possible values for user account types (group membership), per Windows definitio | approver | | unknownFutureValue | -## privilegedAccessGroupAssignmentType values +### privilegedAccessGroupAssignmentType values | Member | | | Possible values for user account types (group membership), per Windows definitio | activated | | unknownFutureValue | -## privilegedAccessGroupMemberType values +### privilegedAccessGroupMemberType values | Member | | | Possible values for user account types (group membership), per Windows definitio | group | | unknownFutureValue | -## privilegedAccessGroupRelationships values +### privilegedAccessGroupRelationships values | Member | | | Possible values for user account types (group membership), per Windows definitio | member | | unknownFutureValue | -## scheduleRequestActions values +### scheduleRequestActions values | Member | | | Possible values for user account types (group membership), per Windows definitio | selfRenew | | unknownFutureValue | -## roleAssignmentScheduleRequestFilterByCurrentUserOptions values +### roleAssignmentScheduleRequestFilterByCurrentUserOptions values | Member | | | Possible values for user account types (group membership), per Windows definitio | approver | | unknownFutureValue | -## roleAssignmentScheduleFilterByCurrentUserOptions values +### roleAssignmentScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## roleAssignmentScheduleInstanceFilterByCurrentUserOptions values +### roleAssignmentScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## roleEligibilityScheduleRequestFilterByCurrentUserOptions values +### roleEligibilityScheduleRequestFilterByCurrentUserOptions values | Member | | | Possible values for user account types (group membership), per Windows definitio | approver | | unknownFutureValue | -## roleEligibilityScheduleFilterByCurrentUserOptions values +### roleEligibilityScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## roleEligibilityScheduleInstanceFilterByCurrentUserOptions values +### roleEligibilityScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## cloudPcAuditActivityOperationType values +### cloudPcAuditActivityOperationType values | Member | | | Possible values for user account types (group membership), per Windows definitio | patch | | other | -## cloudPcAuditActivityResult values +### cloudPcAuditActivityResult values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | timeout | | other | -## cloudPcAuditActorType values +### cloudPcAuditActorType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | partner | | unknown | -## cloudPcAuditCategory values +### cloudPcAuditCategory values | Member | | - | | cloudPC | | other | -## postType values +### postType values | Member | | | Possible values for user account types (group membership), per Windows definitio | strategic | | unknownFutureValue | -## serviceHealthClassificationType values +### serviceHealthClassificationType values | Member | | | Possible values for user account types (group membership), per Windows definitio | incident | | unknownFutureValue | -## serviceHealthOrigin values +### serviceHealthOrigin values | Member | | | Possible values for user account types (group membership), per Windows definitio | customer | | unknownFutureValue | -## serviceHealthStatus values +### serviceHealthStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | reported | | unknownFutureValue | -## serviceUpdateCategory values +### serviceUpdateCategory values | Member | | | Possible values for user account types (group membership), per Windows definitio | stayInformed | | unknownFutureValue | -## serviceUpdateSeverity values +### serviceUpdateSeverity values | Member | | | Possible values for user account types (group membership), per Windows definitio | critical | | unknownFutureValue | -## teamworkApplicationIdentityType values +### teamworkApplicationIdentityType values | Member | | | Possible values for user account types (group membership), per Windows definitio | outgoingWebhook | | unknownFutureValue | -## teamworkConversationIdentityType values +### teamworkConversationIdentityType values | Member | | | Possible values for user account types (group membership), per Windows definitio | chat | | unknownFutureValue | -## teamworkUserIdentityType values +### teamworkUserIdentityType values | Member | | | Possible values for user account types (group membership), per Windows definitio | emailUser | | azureCommunicationServicesUser | -## callRecordingStatus values +### callRecordingStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | chunkFinished | | unknownFutureValue | -## payloadDeliveryPlatform values +### payloadDeliveryPlatform values | Member | | | Possible values for user account types (group membership), per Windows definitio | teams | | unknownFutureValue | -## trainingStatus values +### trainingStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | overdue | | unknownFutureValue | -## teamworkCallEventType values +### teamworkCallEventType values | Member | | | Possible values for user account types (group membership), per Windows definitio | screenShare | | unknownFutureValue | -## binaryOperator values +### binaryOperator values | Member | | | | or | | and | -## subjectRightsRequestStage values +### subjectRightsRequestStage values | Member | | | Possible values for user account types (group membership), per Windows definitio | unknownFutureValue | | approval | -## subjectRightsRequestStageStatus values +### subjectRightsRequestStageStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | failed | | unknownFutureValue | -## subjectRightsRequestStatus values +### subjectRightsRequestStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | closed | | unknownFutureValue | -## subjectRightsRequestType values +### subjectRightsRequestType values | Member | | | Possible values for user account types (group membership), per Windows definitio | tagForAction | | unknownFutureValue | -## dataSubjectType values +### dataSubjectType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | other | | unknownFutureValue | -## answerInputType values +### answerInputType values | Member | Value | Description | | | -- | - | Possible values for user account types (group membership), per Windows definitio | radioButton | 1 | RadioButton. | | unknownFutureValue | 2 | UnknownFutureValue. | -## taskStatus_v2 values +### taskStatus_v2 values | Member | | | Possible values for user account types (group membership), per Windows definitio | completed | | unknownFutureValue | -## wellKnownListName_v2 values +### wellKnownListName_v2 values | Member | | | Possible values for user account types (group membership), per Windows definitio | flaggedEmail | | unknownFutureValue | -## bookingPriceType values +### bookingPriceType values | Member | | | Possible values for user account types (group membership), per Windows definitio | notSet | | unknownFutureValue | -## bookingStaffRole values +### bookingStaffRole values | Member | | | Possible values for user account types (group membership), per Windows definitio | scheduler | | teamMember | -## bookingReminderRecipients values +### bookingReminderRecipients values | Member | | | Possible values for user account types (group membership), per Windows definitio | customer | | unknownFutureValue | -## teamworkConnectionStatus values +### teamworkConnectionStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | disconnected | | unknownFutureValue | -## teamworkDeviceActivityState values +### teamworkDeviceActivityState values | Member | Value | Description | | | -- | | Possible values for user account types (group membership), per Windows definitio | unavailable | 3 | The device is unavailable. | | unknownFutureValue | 4 | Evolvable enumeration sentinel value. Don't use. | -## teamworkDeviceOperationType values +### teamworkDeviceOperationType values | Member | Value | Description | | | -- | | Possible values for user account types (group membership), per Windows definitio | remoteLogout | 6 | Device remote logout. | | unknownFutureValue | 7 | Evolvable enumeration sentinel value. Don't use. | -## teamworkSoftwareFreshness values +### teamworkSoftwareFreshness values | Member | Value | Description | | | -- | -- | Possible values for user account types (group membership), per Windows definitio | updateAvailable | 2 | Indicates that a software update is available for a device component. | | unknownFutureValue | 3 | Evolvable enumeration sentinel value. Don't use. | -## teamworkSoftwareType values +### teamworkSoftwareType values | Member | | | Possible values for user account types (group membership), per Windows definitio | companyPortal | | unknownFutureValue | -## teamworkSupportedClient values +### teamworkSupportedClient values | Member | Value | Description | | -- | -- | | Possible values for user account types (group membership), per Windows definitio | teamsOnly | 4 | Supports only `Teams`. | | unknownFutureValue | 5 | Evolvable enumeration sentinel value. Don't use. | -## delegatedAdminAccessAssignmentStatus values +### delegatedAdminAccessAssignmentStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | error | | unknownFutureValue | -## delegatedAdminAccessContainerType values +### delegatedAdminAccessContainerType values | Member | | | | securityGroup | | unknownFutureValue | -## delegatedAdminRelationshipOperationType values +### delegatedAdminRelationshipOperationType values | Member | | | | delegatedAdminAccessAssignmentUpdate | | unknownFutureValue | -## delegatedAdminRelationshipRequestAction values +### delegatedAdminRelationshipRequestAction values | Member | | | Possible values for user account types (group membership), per Windows definitio | unknownFutureValue | | reject | -## delegatedAdminRelationshipRequestStatus values +### delegatedAdminRelationshipRequestStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | failed | | unknownFutureValue | -## delegatedAdminRelationshipStatus values +### delegatedAdminRelationshipStatus values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | terminationRequested | | unknownFutureValue | -## featureTargetType values +### featureTargetType values | Member | | | Possible values for user account types (group membership), per Windows definitio | role | | unknownFutureValue | -## longRunningOperationStatus values +### longRunningOperationStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | skipped | | unknownFutureValue | -## submissionCategory values +### submissionCategory values | Member | | | Possible values for user account types (group membership), per Windows definitio | malware | | unknownFutureValue | -## submissionClientSource values +### submissionClientSource values | Member | | | Possible values for user account types (group membership), per Windows definitio | other | | unknownFutureValue | -## submissionContentType values +### submissionContentType values | Member | | | Possible values for user account types (group membership), per Windows definitio | app | | unknownFutureValue | -## submissionSource values +### submissionSource values | Member | | | Possible values for user account types (group membership), per Windows definitio | administrator | | unknownFutureValue | -## weakAlgorithms values +### weakAlgorithms values | Member | | | | rsaSha1 | | unknownFutureValue | -## tenantAllowBlockListAction values +### tenantAllowBlockListAction values | Member | | | Possible values for user account types (group membership), per Windows definitio | block | | unknownFutureValue | -## tenantAllowBlockListEntryType values +### tenantAllowBlockListEntryType values | Member | | | Possible values for user account types (group membership), per Windows definitio | recipient | | unknownFutureValue | -## outlierMemberType values +### outlierMemberType values | Member | | | | user | | unknownFutureValue | -## outlierContainerType values +### outlierContainerType values | Member | | | | group | | unknownFutureValue | -## browserSharedCookieSourceEnvironment values +### browserSharedCookieSourceEnvironment values | Member | | | Possible values for user account types (group membership), per Windows definitio | both | | unknownFutureValue | -## browserSiteCompatibilityMode values +### browserSiteCompatibilityMode values | Member | | | Possible values for user account types (group membership), per Windows definitio | internetExplorer5 | | unknownFutureValue | -## browserSiteMergeType values +### browserSiteMergeType values | Member | | | Possible values for user account types (group membership), per Windows definitio | default | | unknownFutureValue | -## browserSiteTargetEnvironment values +### browserSiteTargetEnvironment values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | none | | unknownFutureValue | -## browserSiteStatus values +### browserSiteStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | pendingDelete | | unknownFutureValue | -## browserSharedCookieStatus values +### browserSharedCookieStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | pendingDelete | | unknownFutureValue | -## browserSiteListStatus values +### browserSiteListStatus values | Member | | | Possible values for user account types (group membership), per Windows definitio | pending | | unknownFutureValue | -## authenticationStrengthPolicyType values +### authenticationStrengthPolicyType values | Member | | | Possible values for user account types (group membership), per Windows definitio | custom | | unknownFutureValue | -## authenticationStrengthRequirements values +### authenticationStrengthRequirements values | Member | | | Possible values for user account types (group membership), per Windows definitio | mfa | | unknownFutureValue | -## authenticationStrengthResult values +### authenticationStrengthResult values | Member | | | Possible values for user account types (group membership), per Windows definitio | cannotSatisfy | | unknownFutureValue | -## authenticationMethodModes values +### authenticationMethodModes values | Member | | | Possible values for user account types (group membership), per Windows definitio | federatedMultiFactor | | unknownFutureValue | -## baseAuthenticationMethod values +### baseAuthenticationMethod values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | federation | | unknownFutureValue | -## searchContent values +### searchContent values | Member | | | Possible values for user account types (group membership), per Windows definitio | sharedContent | | unknownFutureValue | -## chatMessageActions values +### chatMessageActions values | Member | | | Possible values for user account types (group membership), per Windows definitio | actionUndefined | | unknownFutureValue | -## plannerRelationshipUserRoles values +### plannerRelationshipUserRoles values | Member | | | Possible values for user account types (group membership), per Windows definitio | applications | | unknownFutureValue | -## plannerRuleKind values +### plannerRuleKind values | Member | | | Possible values for user account types (group membership), per Windows definitio | planRule | | unknownFutureValue | -## plannerUserRoleKind values +### plannerUserRoleKind values | Member | | | | relationship | | unknownFutureValue | -## plannerTaskTargetKind values +### plannerTaskTargetKind values | Member | | | | group | | unknownFutureValue | -## onPremisesDirectorySynchronizationDeletionPreventionType values +### onPremisesDirectorySynchronizationDeletionPreventionType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | enabledForPercentage | | unknownFutureValue | -## authenticationMethodsPolicyMigrationState values +### authenticationMethodsPolicyMigrationState values | Member | | - | Possible values for user account types (group membership), per Windows definitio | migrationComplete | | unknownFutureValue | -## authenticationEventType values +### authenticationEventType values | Member | | | Possible values for user account types (group membership), per Windows definitio | pageRenderStart | | unknownFutureValue | -## microsoftAuthenticatorAuthenticationMethodClientAppName values +### microsoftAuthenticatorAuthenticationMethodClientAppName values | Member | | - | Possible values for user account types (group membership), per Windows definitio | outlookMobile | | unknownFutureValue | -## userDefaultAuthenticationMethodType values +### userDefaultAuthenticationMethodType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | sms | | unknownFutureValue | -## endUserNotificationPreference values +### endUserNotificationPreference values | Member | | - | Possible values for user account types (group membership), per Windows definitio | custom | | unknownFutureValue | -## endUserNotificationSettingType values +### endUserNotificationSettingType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | noNotification | | unknownFutureValue | -## endUserNotificationType values +### endUserNotificationType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | trainingReminder | | unknownFutureValue | -## notificationDeliveryFrequency values +### notificationDeliveryFrequency values | Member | | - | Possible values for user account types (group membership), per Windows definitio | biWeekly | | unknownFutureValue | -## notificationDeliveryPreference values +### notificationDeliveryPreference values | Member | | - | Possible values for user account types (group membership), per Windows definitio | deliverAfterCampaignEnd | | unknownFutureValue | -## oAuthAppScope values +### oAuthAppScope values | Member | | - | Possible values for user account types (group membership), per Windows definitio | sendMail | | unknownFutureValue | -## targettedUserType values +### targettedUserType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | allUsers | | unknownFutureValue | -## trainingAssignedTo values +### trainingAssignedTo values | Member | | - | Possible values for user account types (group membership), per Windows definitio | didNothing | | unknownFutureValue | -## trainingAvailabilityStatus values +### trainingAvailabilityStatus values | Member | | - | Possible values for user account types (group membership), per Windows definitio | delete | | unknownFutureValue | -## trainingCompletionDuration values +### trainingCompletionDuration values | Member | | - | Possible values for user account types (group membership), per Windows definitio | month | | unknownFutureValue | -## trainingSettingType values +### trainingSettingType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | custom | | unknownFutureValue | -## trainingType values +### trainingType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | phishing | | unknownFutureValue | -## verifiableCredentialPresentationStatusCode values +### verifiableCredentialPresentationStatusCode values | Member | | | Possible values for user account types (group membership), per Windows definitio | presentation_verified | | unknownFutureValue | -## labelKind values +### labelKind values | Member | | - | Possible values for user account types (group membership), per Windows definitio | enumerated | | unknownFutureValue | -## permissionKind values +### permissionKind values | Member | | - | Possible values for user account types (group membership), per Windows definitio | allPermissionsOnResourceApp | | unknownFutureValue | -## resourceScopeType values +### resourceScopeType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | tenant | | unknownFutureValue | -## rootDomains values +### rootDomains values | Member | | - | Possible values for user account types (group membership), per Windows definitio | allManagedAndEnumeratedFederated | | unknownFutureValue | -## allowedRolePrincipalTypes values +### allowedRolePrincipalTypes values | Member | | - | Possible values for user account types (group membership), per Windows definitio | group | | unknownFutureValue | -## b2bIdentityProvidersType values +### b2bIdentityProvidersType values | Member | | | Possible values for user account types (group membership), per Windows definitio | defaultConfiguredIdp | | unknownFutureValue | -## authorizationSystemActionSeverity values +### authorizationSystemActionSeverity values | Member | | - | Possible values for user account types (group membership), per Windows definitio | high | | unknownFutureValue | -## authorizationSystemActionType values +### authorizationSystemActionType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | read | | unknownFutureValue | -## awsPolicyType values +### awsPolicyType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | custom | | unknownFutureValue | -## awsRoleTrustEntityType values +### awsRoleTrustEntityType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | webIdentity | | unknownFutureValue | -## awsRoleType values +### awsRoleType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | custom | | unknownFutureValue | -## awsStatementEffect values +### awsStatementEffect values | Member | | - | Possible values for user account types (group membership), per Windows definitio | deny | | unknownFutureValue | -## azureRoleDefinitionType values +### azureRoleDefinitionType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | custom | | unknownFutureValue | -## dataCollectionStatus values +### dataCollectionStatus values | Member | | - | Possible values for user account types (group membership), per Windows definitio | offline | | unknownFutureValue | -## gcpRoleType values +### gcpRoleType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | custom | | unknownFutureValue | -## permissionsDefinitionIdentityType values +### permissionsDefinitionIdentityType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | serviceAccount | | unknownFutureValue | -## permissionsModificationCapability values +### permissionsModificationCapability values | Member | | - | Possible values for user account types (group membership), per Windows definitio | noRecentDataCollected | | unknownFutureValue | -## permissionsRequestOccurrenceStatus values +### permissionsRequestOccurrenceStatus values | Member | | - | Possible values for user account types (group membership), per Windows definitio | revokingFailed | | unknownFutureValue | -## statusDetail values +### statusDetail values | Member | | - | Possible values for user account types (group membership), per Windows definitio | rejected | | unknownFutureValue | -## socialIdentitySourceType values +### socialIdentitySourceType values | Member | | - | | facebook | | unknownFutureValue | -## authorizationSystemType values +### authorizationSystemType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | aws | | unknownFutureValue | -## awsAccessType values +### awsAccessType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | private | | unknownFutureValue | -## awsSecretInformationWebServices values +### awsSecretInformationWebServices values | Member | | - | Possible values for user account types (group membership), per Windows definitio | certificateManager | | unknownFutureValue | -## awsSecurityToolWebServices values +### awsSecurityToolWebServices values | Member | | - | Possible values for user account types (group membership), per Windows definitio | guardDuty | | unknownFutureValue | -## azureAccessType values +### azureAccessType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | private | | unknownFutureValue | -## azureEncryption values +### azureEncryption values | Member | | - | Possible values for user account types (group membership), per Windows definitio | customer | | unknownFutureValue | -## externalSystemAccessMethods values +### externalSystemAccessMethods values | Member | | - | Possible values for user account types (group membership), per Windows definitio | roleChaining | | unknownFutureValue | -## gcpAccessType values +### gcpAccessType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | private | | unknownFutureValue | -## gcpEncryption values +### gcpEncryption values | Member | | - | Possible values for user account types (group membership), per Windows definitio | customer | | unknownFutureValue | -## iamStatus values +### iamStatus values | Member | | - | Possible values for user account types (group membership), per Windows definitio | disabled | | unknownFutureValue | -## devicePlatformType values +### devicePlatformType values | Member | | -- | Possible values for user account types (group membership), per Windows definitio | iOSMobileApplicationManagement | | unknownFutureValue | -## bookingPageAccessControl values +### bookingPageAccessControl values | Member | | - | Possible values for user account types (group membership), per Windows definitio | restrictedToOrganization | | unknownFutureValue | -## bookingsServiceAvailabilityType values +### bookingsServiceAvailabilityType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | customWeeklyHours | | unknownFutureValue | -## conditionalAccessTransferMethods values +### conditionalAccessTransferMethods values | Member | | - | Possible values for user account types (group membership), per Windows definitio | authenticationTransfer | | unknownFutureValue | -## claimConditionUserType values +### claimConditionUserType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | externalGuests | | unknownFutureValue | -## filterType values +### filterType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | contains | | unknownFutureValue | -## matchOn values +### matchOn values | Member | | - | Possible values for user account types (group membership), per Windows definitio | samAccountName | | unknownFutureValue | -## samlAttributeNameFormat values +### samlAttributeNameFormat values | Member | | - | Possible values for user account types (group membership), per Windows definitio | basic | | unknownFutureValue | -## samlNameIDFormat values +### samlNameIDFormat values | Member | | - | Possible values for user account types (group membership), per Windows definitio | persistent | | unknownFutureValue | -## samlSLOBindingType values +### samlSLOBindingType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | httpPost | | unknownFutureValue | -## tokenFormat values +### tokenFormat values | Member | | - | Possible values for user account types (group membership), per Windows definitio | jwt | | unknownFutureValue | -## transformationExtractType values +### transformationExtractType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | suffix | | unknownFutureValue | -## transformationTrimType values +### transformationTrimType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | leadingAndTrailing | | unknownFutureValue | -## sharingRole values +### sharingRole values | Member | | - | Possible values for user account types (group membership), per Windows definitio | submitOnly | | unknownFutureValue | -## sharingScope values +### sharingScope values | Member | | - | Possible values for user account types (group membership), per Windows definitio | users | | unknownFutureValue | -## sharingVariant values +### sharingVariant values | Member | | - | Possible values for user account types (group membership), per Windows definitio | embed | | unknownFutureValue | -## trustFrameworkKeyStatus values +### trustFrameworkKeyStatus values | Member | | - | Possible values for user account types (group membership), per Windows definitio | disabled | | unknownFutureValue | -## conditionalAccessInsiderRiskLevels values +### conditionalAccessInsiderRiskLevels values | Member | | - | Possible values for user account types (group membership), per Windows definitio | elevated | | unknownFutureValue | -## compliantNetworkType values +### compliantNetworkType values | Member | | - | | allTenantCompliantNetworks | | unknownFutureValue | -## meetingRequestType values +### meetingRequestType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | outdated | | principalWantsCopy | -## photoUpdateSource values +### photoUpdateSource values | Member | | - | | cloud | | onPremises | -## uriUsageType values +### uriUsageType values | Member | | - | Possible values for user account types (group membership), per Windows definitio | logoutUrl | | unknownFutureValue | -## nativeAuthenticationApisEnabled values +### nativeAuthenticationApisEnabled values | Member | | - | |
v1.0 | Onlinemeeting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onlinemeeting.md | Contains information about a meeting, including the URL used to join a meeting, This resource supports subscribing to [change notifications](/graph/webhooks). For more information, see [subscribe to online meetings](/graph/changenotifications-for-onlinemeeting). -Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md). +Inherits from [onlineMeetingBase](../resources/onlinemeetingbase.md). ## Methods Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md). | Property | Type | Description | | :-- | :-- | : |-| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. Possible values are: `everyone`, `organization`, `roleIsPresenter`, `organizer`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowLiveShare | [meetingLiveShareOptions](#meetingliveshareoptions-values) | Indicates whether live share is enabled for the meeting. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Possible values are: `enabled`, `disabled`, `limited`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. |+| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md).| +| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | chatRestrictions | [chatrestrictions](../resources/chatrestrictions.md) | Specifies the configuration for meeting chat restrictions. |-| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).| -| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | creationDateTime | DateTime | The meeting creation time in UTC. Read-only. | | endDateTime | DateTime | The meeting end time in UTC. Required when you create an online meeting. | | externalId | String | The external ID. A custom ID. Optional. |-| id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| id | String | The default ID associated with the online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | joinWebUrl | String | The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). |-| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | meetingTemplateId | String | The ID of the [meeting template](/microsoftteams/create-custom-meeting-template). | | participants | [meetingParticipants](meetingparticipants.md) | The participants associated with the online meeting, including the organizer and the attendees. |-| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| recordAutomatically | Boolean | Indicates whether to record the meeting automatically. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | startDateTime | DateTime | The meeting start time in UTC. Required when you create an online meeting. |-| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| subject | String | The subject of the online meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | alternativeRecording (deprecated) | Stream | The content stream of the alternative recording of a [Microsoft Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | attendeeReport (deprecated) | Stream | The content stream of the attendee report of a [Teams live event](/microsoftteams/teams-live-events/what-are-teams-live-events). Read-only. | | autoAdmittedUsers (deprecated) | String | The setting that specifies the type of participants that are automatically allowed into the online meeting. Possible values are: `everyone`, `everyoneInSameAndFederatedCompany`, `everyoneInCompany`, `invitedUsersInCompany`, `organizer`. Read-only. | Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md). >- The **autoAdmittedUsers** property is deprecated. Use the **scope** property of [lobbyBypassSettings](lobbybypasssettings.md) instead. >- The **capabilities** property is deprecated. Use the **isQuestionAndAnswerEnabled** property of [broadcastMeetingSettings](broadcastMeetingSettings.md) instead. -### onlineMeetingPresenters values --| Value | Description | -| | - | -| everyone | Everyone is a presenter. Default. | -| organization | Everyone in organizerΓÇÖs organization is a presenter. | -| roleIsPresenter | Only the participants whose role is presenter are presenters. | -| organizer | Only the organizer is a presenter. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +### meetingChatHistoryDefaultMode values -> [!TIP] -> -> When creating or updating an online meeting with **allowedPresenters** set to `roleIsPresenter`, include a full list of **attendees** with the specified attendees' **role** set to `presenter` in the request body. +| Value | Description | +| | - | +| all | All meeting chat history is shared. | +| none | No meeting chat history is shared. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ### meetingChatMode values Inherits from [onlineMeetingBase](../resources/onlineMeetingBase.md). | | - | | enabled | Meeting chat is enabled. | | disabled | Meeting chat is disabled. |-| limited | Meeting chat is enabled but only during the meeting call. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| limited | Meeting chat is enabled but only during the meeting call. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | -### meetingChatHistoryDefaultMode values +### meetingLiveShareOptions values | Value | Description | | | - |-| all | All meeting chat history is shared. | -| none | No meeting chat history is shared. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| enabled | Meeting live share is enabled. | +| disabled | Meeting live share is disabled. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ++### onlineMeetingPresenters values ++| Value | Description | +| | - | +| everyone | Everyone is a presenter. Default. | +| organization | Everyone in organizerΓÇÖs organization is a presenter. | +| roleIsPresenter | Only the participants whose role is presenter are presenters. | +| organizer | Only the organizer is a presenter. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ++> [!TIP] +> +> When creating or updating an online meeting with **allowedPresenters** set to `roleIsPresenter`, include a full list of **attendees** with the specified attendees' **role** set to `presenter` in the request body. ## Relationships | Relationship | Type | Description | | | - | -- |-| attendanceReports | [meetingAttendanceReport](meetingattendancereport.md) collection | The attendance reports of an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| attendanceReports | [meetingAttendanceReport](meetingattendancereport.md) collection | The attendance reports of an online meeting. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | recordings | [callRecording](callrecording.md) collection | The recordings of an online meeting. Read-only. | | transcripts | [callTranscript](calltranscript.md) collection | The transcripts of an online meeting. Read-only. | | meetingAttendanceReport (deprecated) | [meetingAttendanceReport](meetingattendancereport.md) | The attendance report of the latest online meeting session. Read-only. | The following JSON representation shows the resource type. { "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean",- "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"}, - "allowTeamworkReactions": "Boolean", + "allowBreakoutRooms": "Boolean", "allowedPresenters": "String",+ "allowLiveShare": "String", + "allowMeetingChat": "String", + "allowParticipantsToChangeName": "Boolean", + "allowPowerPointSharing": "Boolean", + "allowRecording": "Boolean", + "allowTeamworkReactions": "Boolean", + "allowTranscription": "Boolean", + "allowWhiteboard": "Boolean", "anonymizeIdentityForRoles": ["String"], "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"}, The following JSON representation shows the resource type. "meetingTemplateId": "String", "participants": {"@odata.type": "microsoft.graph.meetingParticipants"}, "recordAutomatically": "Boolean",- "shareMeetingChatHistoryDefault": "microsoft.graph.meetingChatHistoryDefaultMode", + "shareMeetingChatHistoryDefault": "String", "startDateTime": "String (timestamp)", "subject": "String", "videoTeleconferenceId": "String", |
v1.0 | Onlinemeetingbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/onlinemeetingbase.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a base online meeting. The base type of [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualEventSession.md). +Represents a base online meeting. The base type of [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualeventsession.md). Inherits from [entity](../resources/entity.md). > [!TIP]-> This is an abstract type and can't be used directly. Use the derived types [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualEventSession.md) instead. +> This is an abstract type and can't be used directly. Use the derived types [onlineMeeting](onlinemeeting.md) and [virtualEventSession](virtualeventsession.md) instead. ## Properties Inherits from [entity](../resources/entity.md). | :-- | :-- | : | | allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. | | allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. |-| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the meeting. | +| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. Possible values are: `everyone`, `organization`, `roleIsPresenter`, `organizer`, `unknownFutureValue`. | +| allowLiveShare | [meetingLiveShareOptions](#meetingliveshareoptions-values) | Indicates whether live share is enabled for the meeting. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. | +| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Possible values are: `enabled`, `disabled`, `limited`, `unknownFutureValue`. | | allowParticipantsToChangeName | Boolean | Specifies if participants are allowed to rename themselves in an instance of the meeting. |+| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the meeting. | +| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. | | allowTeamworkReactions | Boolean | Indicates if Teams reactions are enabled for the meeting. | | allowTranscription | Boolean | Indicates whether transcription is enabled for the meeting. |-| allowRecording | Boolean | Indicates whether recording is enabled for the meeting. | -| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a meeting. | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the meeting. | | anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the meeting. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added.| | audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for an online meeting. Read-only. | | chatInfo | [chatInfo](chatinfo.md) | The chat information associated with this online meeting. | Inherits from [entity](../resources/entity.md). | joinInformation | [itemBody](itembody.md) | The join information in the language and locale variant specified in 'Accept-Language' request HTTP header. Read-only. | | joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Once an **onlineMeeting** is created, the **joinMeetingIdSettings** can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. | | joinWebUrl | String | The join URL of the online meeting. Read-only. |-| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. | +| lobbyBypassSettings | [lobbyBypassSettings](lobbybypasssettings.md) | Specifies which participants can bypass the meeting lobby. | | recordAutomatically | Boolean | Indicates whether to record the meeting automatically. |-| shareMeetingChatHistoryDefault | meetingChatHistoryDefaultMode |Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`.| +| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) |Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`.| | subject | String | The subject of the online meeting. | | videoTeleconferenceId | String | The video teleconferencing ID. Read-only. | | watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. | -### onlineMeetingPresenters values +### meetingChatHistoryDefaultMode values -| Value | Description | -| | - | -| everyone | Everyone is a presenter. Default. | -| organization | Everyone in organizerΓÇÖs organization is a presenter. | -| roleIsPresenter | Only the participants whose role is presenter are presenters. | -| organizer | Only the organizer is a presenter. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| Value | Description | +| | - | +| all | All meeting chat history is shared. | +| none | No meeting chat history is shared. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ### meetingChatMode values Inherits from [entity](../resources/entity.md). | limited | Meeting chat is enabled but only during the meeting call. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | -### meetingChatHistoryDefaultMode values +### meetingLiveShareOptions values | Value | Description | | | - |-| all | All meeting chat history is shared. | -| none | No meeting chat history is shared. | +| enabled | Meeting live share is enabled. | +| disabled | Meeting live share is disabled. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +### onlineMeetingPresenters values ++| Value | Description | +| | - | +| everyone | Everyone is a presenter. Default. | +| organization | Everyone in organizerΓÇÖs organization is a presenter. | +| roleIsPresenter | Only the participants whose role is presenter are presenters. | +| organizer | Only the organizer is a presenter. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | + ## Relationships | Relationship | Type | Description | The following JSON representation shows the resource type. { "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean",- "allowMeetingChat": {"@odata.type": "microsoft.graph.meetingChatMode"}, - "allowTeamworkReactions": "Boolean", + "allowBreakoutRooms": "Boolean", "allowedPresenters": "String",+ "allowLiveShare": "String", + "allowMeetingChat": "String", + "allowParticipantsToChangeName": "Boolean", + "allowPowerPointSharing": "Boolean", + "allowRecording": "Boolean", + "allowTeamworkReactions": "Boolean", + "allowTranscription": "Boolean", + "allowWhiteboard": "Boolean", "anonymizeIdentityForRoles": ["String"], "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},- "id": "String (identifier)", + "id": "String (identifier)", "isEntryExitAnnounced": "Boolean", "joinInformation": {"@odata.type": "microsoft.graph.itemBody"}, "joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"}, "joinWebUrl": "String", "lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"}, "recordAutomatically": "Boolean",- "shareMeetingChatHistoryDefault": "microsoft.graph.meetingChatHistoryDefaultMode", + "shareMeetingChatHistoryDefault": "String", "subject": "String", "videoTeleconferenceId": "String", "watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"} |
v1.0 | Openidconnectsetting | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/openidconnectsetting.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -A complex type that contains the settings required to perform the OIDC request to the external authentication provider for an external authentication method. External authentication methods enable Microsoft Entra ID users to satisfy the second factor of multifactor authentication requirements using an external provider. +A complex type that contains the settings required to perform the OIDC request to the external authentication provider for an [external authentication method](../resources/externalauthenticationmethodconfiguration.md). External authentication methods enable Microsoft Entra ID users to satisfy the second factor of multifactor authentication requirements using an external provider. ## Properties |Property|Type|Description| |
v1.0 | Outlookcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlookcategory.md | ms.localizationpriority: medium doc_type: resourcePageType+toc. Title: Outlook category (deprecated) # outlookCategory resource type You can also [get this master list of categories](../api/outlookuser-list-master You can apply a category to an item by assigning the **displayName** property of the category to the **categories** collection of the item. Resources that can be assigned categories include [contact](contact.md), [event](event.md), [message](message.md), [outlookTask](outlooktask.md), [post](post.md), and [todoTask](todotask.md). -Each category is attributed by 2 properties: **displayName** and **color**. The **displayName** value must be unique in a user's master list. -The **color** however does not have to be unique; multiple categories in the master list can be mapped to the same color. You can map up to 25 different colors to categories in a user's master list. +Each category is attributed by two properties: **displayName** and **color**. The **displayName** value must be unique in a user's master list. +The **color** however doesn't have to be unique; multiple categories in the master list can be mapped to the same color. You can map up to 25 different colors to categories in a user's master list. ## Methods | Method | Return Type |Description| |:|:--|:-|-|[List categories](../api/outlookuser-list-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) collection |Get all the categories that have been defined for the user.| -|[Get category](../api/outlookcategory-get.md) | [outlookCategory](../resources/outlookcategory.md) |Get the properties and relationships of the specified **outlookCategory** object.| -|[Create category](../api/outlookuser-post-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) |Create an **outlookCategory** object in the user's master list of categories.| -|[Update category](../api/outlookcategory-update.md) | [outlookCategory](../resources/outlookcategory.md) |Update the writable property, **color**, of the specified **outlookCategory** object. | -|[Delete category](../api/outlookcategory-delete.md) | None |Delete the specified **outlookCategory** object. | +|[List](../api/outlookuser-list-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) collection |Get all the categories that have been defined for the user.| +|[Get](../api/outlookcategory-get.md) | [outlookCategory](../resources/outlookcategory.md) |Get the properties and relationships of the specified **outlookCategory** object.| +|[Create](../api/outlookuser-post-mastercategories.md) | [outlookCategory](../resources/outlookcategory.md) |Create an **outlookCategory** object in the user's master list of categories.| +|[Update](../api/outlookcategory-update.md) | [outlookCategory](../resources/outlookcategory.md) |Update the writable property, **color**, of the specified **outlookCategory** object. | +|[Delete](../api/outlookcategory-delete.md) | None |Delete the specified **outlookCategory** object. | ## Properties | Property | Type |Description| |:|:--|:-|-|color|String|A pre-set color constant that characterizes a category, and that is mapped to one of 25 predefined colors. For more details, see the following note. | -|displayName|String|A unique name that identifies a category in the user's mailbox. After a category is created, the name cannot be changed. Read-only.| +|color|String|A preset color constant that characterizes a category, and that is mapped to one of 25 predefined colors. For more information, see the following note. | +|displayName|String|A unique name that identifies a category in the user's mailbox. After a category is created, the name can't be changed. Read-only.| -> **Note** The possible values for **color** are pre-set constants such as `None`, `preset0` and `preset1`. Each pre-set constant is further mapped to a color; the actual -color is dependent on the Outlook client that the categories are being displayed in. The following table shows the colors mapped to each pre-set constant for Outlook (desktop client). +> **Note** The possible values for **color** are preset constants such as `None`, `preset0` and `preset1`. Each preset constant is further mapped to a color; the actual +color is dependent on the Outlook client that the categories are being displayed in. The following table shows the colors mapped to each preset constant for Outlook (desktop client). -| Pre-set constant | Color mapped to in Outlook | +| Preset constant | Color mapped to in Outlook | |:|:--| | None | No color mapped | | Preset0 | Red | |
v1.0 | Outlooktask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktask.md | +toc. Title: Outlook task (deprecated) # outlookTask resource type (deprecated) |
v1.0 | Outlooktaskfolder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktaskfolder.md | +toc. Title: Outlook task folder (deprecated) # outlookTaskFolder resource type (deprecated) |
v1.0 | Outlooktaskgroup | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/outlooktaskgroup.md | +toc. Title: Outlook task group (deprecated) # outlookTaskGroup resource type (deprecated) |
v1.0 | Plannerchecklistitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerchecklistitem.md | The **plannerChecklistItem** resource represents an item in the checklist of a t |:|:--|:-| |isChecked|Boolean|Value is `true` if the item is checked and `false` otherwise.| |lastModifiedBy|[identitySet](identityset.md)| Read-only. User ID by which this is last modified.|-|lastModifiedDateTime|DateTimeOffset|Read-only. Date and time at which this is last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +|lastModifiedDateTime|DateTimeOffset|Read-only. Date and time at which this is last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |orderHint|String|Used to set the relative order of items in the checklist. The format is defined as outlined [here](planner-order-hint-format.md).|-|title|String|Title of the checklist item| +|title|String|Title of the checklist item.| ++## Relationships ++None. ## Relationships |
v1.0 | Plannerchecklistitems | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerchecklistitems.md | Title: "plannerChecklistItems resource type" -description: "The **plannerChecklistItemCollection** resource represents the collection of checklist items on a task. It's an Open Type. It's part of the task details object. The value in the property-value pair is the checklistItem object." +description: "Represents the collection of checklist items on a task. This complex type is an open type that's part of the task details object. The value in the property-value pair is the checklistItem object." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The **plannerChecklistItemCollection** resource represents the collection of checklist items on a task. It's an Open Type. It's part of the [task details](plannertaskdetails.md) object. The value in the property-value pair is the [checklistItem](plannerchecklistitem.md) object. +Represents the collection of checklist items on a task. This complex type is an open type that's part of the [task details](plannertaskdetails.md) object. The value in the property-value pair is the [checklistItem](plannerchecklistitem.md) object. ## Properties-Properties of an Open Type can be defined by the client. In this case, the client should provide **GUIDs** as properties and their values must be [checklistItem](plannerchecklistitem.md) objects. Example is shown below. To remove an item in the checklist, set the value of the property to `null`. +Properties of an open type can be defined by the client. In this case, the client should provide **GUIDs** as properties and their values must be [checklistItem](plannerchecklistitem.md) objects. To remove an item in the checklist, set the value of the property to `null`. ## Relationships The following JSON representation shows the resource type. { "String-value": {+ "@odata.type": "microsoft.graph.plannerChecklistItem", "isChecked": true,- "lastModifiedBy": "String-value", + "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"}, "lastModifiedByDateTime": "String(timestamp)", "orderHint": "String-value", "title": "String-value" } }-``` -// Example --```json -{ - "3a73c9dd-fb47-4230-9c0f-b80788fb0f9b": // client-generated GUID - { - "@odata.type": "microsoft.graph.checklistItem", // required in PATCH requests to edit the checklist on a task - "isChecked": true, - "lastModifiedBy": { - "user": { - "id": "ebf3b108-5234-4e22-b93d-656d7dae5874" - } - }, - "lastModifiedByDateTime": "2015-09-21T17:45:12.039Z", - "orderHint": "0009005756397228702", - "title": "Get stamps" - }, - "5f36f5b2-1ec0-4c48-9c75-ed59429516c5": - { - "@odata.type": "microsoft.graph.checklistItem", - "isChecked": false, - "lastModifiedBy": { - "user": { - "id": "ebf3b108-5234-4e22-b93d-656d7dae5874" - } - }, - "lastModifiedByDateTime": "2015-09-21T17:45:12.039Z", - "orderHint": "0004105723397228784", - "title": "Mail card at UPS" - } -} - ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 |
v1.0 | Plannerplan | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplan.md | Represents a plan in Microsoft 365. Either a [group](group.md) or a [user](user. | Method | Return Type |Description| |:|:--|:-|-|[Get plan](../api/plannerplan-get.md) | [plannerPlan](plannerplan.md) |Read properties and relationships of **plannerPlan** object.| +|[Create](../api/planner-post-plans.md) | [plannerPlan](plannerplan.md) |Create a **plannerPlan** object.| +|[Get](../api/plannerplan-get.md) | [plannerPlan](plannerplan.md) |Read properties and relationships of **plannerPlan** object.| +|[Update](../api/plannerplan-update.md) | [plannerPlan](plannerplan.md) |Update **plannerPlan** object. | +|[Delete](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. | +|[Archive plan](../api/plannerplan-archive.md) | [plannerPlan](plannerplan.md) | Archive a **plannerPlan** object.| +|[Unarchive plan](../api/plannerplan-unarchive.md) | [plannerPlan](plannerplan.md) | Unarchive an archived **plannerPlan** object.| +|[Move to container](../api/plannerplan-movetocontainer.md) | [plannerPlan](../resources/plannerplan.md) | Move a **plannerPlan** object from one **plannerPlanContainer** to another. | |[List plan buckets](../api/plannerplan-list-buckets.md) |[plannerBucket](plannerbucket.md) collection| Get a **plannerBucket** object collection.| |[List plan tasks](../api/plannerplan-list-tasks.md) |[plannerTask](plannertask.md) collection| Get a **plannerTask** object collection.|-|[Update plan](../api/plannerplan-update.md) | [plannerPlan](plannerplan.md) |Update **plannerPlan** object. | -|[Delete plan](../api/plannerplan-delete.md) | None | Delete **plannerPlan** object. | |[Get delta](../api/plannerplan-delta.md) | [plannerPlan](../resources/plannerplan.md) collection | Get newly created, updated, or deleted **plannerPlan** objects in either a **group** or a [plannerRoster](plannerroster.md) type container without having to perform a full read of the entire resource collection. |-|[Move to container](../api/plannerplan-movetocontainer.md) | [plannerPlan](../resources/plannerplan.md) | Move a **plannerPlan** object from one **plannerPlanContainer** to another. | -|[Archive plan](../api/plannerplan-archive.md) | [plannerPlan](plannerplan.md) | Archive a **plannerPlan** object.| -|[Unarchive plan](../api/plannerplan-unarchive.md) | [plannerPlan](plannerplan.md) | Unarchive an archived **plannerPlan** object.| ## Properties | Property | Type |Description| |
v1.0 | Plannerplanconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplanconfiguration.md | Inherits from [entity](../resources/entity.md). |:|:|:| |[Get](../api/plannerplanconfiguration-get.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Read the properties and relationships of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object.| |[Update](../api/plannerplanconfiguration-update.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Update the properties of a [plannerPlanConfiguration](../resources/plannerplanconfiguration.md) object for a [businessScenario](../resources/businessscenario.md). |-|[List](../api/plannerplanconfiguration-list-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Get the plannerPlanConfigurationLocalization resources from the localizations navigation property.| -|[Create](../api/plannerplanconfiguration-post-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Create a new plannerPlanConfigurationLocalization object.| ## Properties |
v1.0 | Plannerplanconfigurationlocalization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannerplanconfigurationlocalization.md | Inherits from [entity](../resources/entity.md). |Method|Return type|Description| |:|:|:| |[List](../api/plannerplanconfiguration-list-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) collection|Get a list of the [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) objects and their properties.|-|[Create](../api/plannerplanconfiguration-post-localizations.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Create a new [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.| -|[Get](../api/plannerplanconfigurationlocalization-get.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Read the properties and relationships of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.| -|[Update](../api/plannerplanconfigurationlocalization-update.md)|[plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md)|Update the properties of a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.| -|[Delete](../api/plannerplanconfiguration-delete-localizations.md)|None|Delete a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) object.| +|[Update](../api/plannerplanconfiguration-update.md)|[plannerPlanConfiguration](../resources/plannerplanconfiguration.md)|Add, remove, or update a [plannerPlanConfigurationLocalization](../resources/plannerplanconfigurationlocalization.md) via the update of the plannerPlanConfiguration.| ## Properties |Property|Type|Description| |
v1.0 | Plannertask | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/plannertask.md | Represents a planner task in Microsoft 365. A planner task is contained in a [pl | Method | Return Type |Description| |:|:--|:-|-|[Get task](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read the properties and relationships of **plannerTask** object.| -|[Update task](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update a **plannerTask** object. | -|[Delete task](../api/plannertask-delete.md) | None |Delete a **plannerTask** object. | +|[Create](../api/planner-post-tasks.md) | [plannerTask](plannertask.md) |Create a **plannerTask** object.| +|[Get](../api/plannertask-get.md) | [plannerTask](plannertask.md) |Read the properties and relationships of **plannerTask** object.| +|[Update](../api/plannertask-update.md) | [plannerTask](plannertask.md) |Update a **plannerTask** object. | +|[Delete](../api/plannertask-delete.md) | None |Delete a **plannerTask** object. | |[Get delta](../api/plannertask-delta.md)|[plannerTask](../resources/plannertask.md) collection| Get newly created, updated, or deleted **plannerTask** objects in either a **plannerPlan** or assigned to the signed-in user without having to perform a full read of the entire resource collection. | ## Properties |
v1.0 | Report | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/report.md | Microsoft Graph controls access to resources via permissions. You must specify t ## Settings -In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values are not displayed. You can use the [adminReportSettings](/graph/api/resources/adminreportsettings?view=graph-rest-beta&preserve-view=true) API to control the display of user information in the reports. +In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values aren't displayed. You can use the [adminReportSettings](../resources/adminreportsettings.md) API to control the display of user information in the reports. ## Cloud deployments The following table shows the availability for each API across all cloud deploym | APIs | Microsoft Graph global service | **Microsoft Cloud for US Government** | **Microsoft Cloud China operated by 21Vianet** | **Microsoft Cloud for USNat and USSec** | | | | - | - | |-| [Admin Report Settings](/graph/api/resources/adminreportsettings?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [Microsoft 365 activations](/graph/api/resources/office-365-activations-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | -| [Microsoft 365 active users](/graph/api/resources/office-365-active-users-reports?view=graph-rest-beta&preserve-view=true)| Γ£ö | Γ£ö | Γ£ö | Γ₧û | -| [Microsoft 365 Apps usage](/graph/api/resources/microsoft-365-apps-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | -| [Microsoft 365 browser usage](/graph/api/resources/microsoft-365-browser-usage-report?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | -| [Microsoft 365 groups activity](/graph/api/resources/office-365-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | -| [Microsoft Forms Usage](/graph/api/resources/microsoft-forms-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | -| [Microsoft Teams device usage](/graph/api/resources/microsoft-teams-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [Microsoft Teams team usage](/graph/api/resources/microsoft-teams-team-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [Microsoft Teams user activity](/graph/api/resources/microsoft-teams-user-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [Outlook activity](/graph/api/resources/email-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [Outlook app usage](/graph/api/resources/email-app-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [Outlook mailbox usage](/graph/api/resources/mailbox-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [OneDrive activity](/graph/api/resources/onedrive-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [OneDrive usage](/graph/api/resources/onedrive-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [SharePoint activity](/graph/api/resources/sharepoint-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [SharePoint site usage](/graph/api/resources/sharepoint-site-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | -| [Skype for Business activity](/graph/api/resources/skype-for-business-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | -| [Skype for Business device usage](/graph/api/resources/skype-for-business-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | -| [Skype for Business organizer activity](/graph/api/resources/skype-for-business-organizer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | -| [Skype for Business participant activity](/graph/api/resources/skype-for-business-participant-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | -| [Skype for Business peer-to-peer activity](/graph/api/resources/skype-for-business-peer-to-peer-activity?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | -| [Yammer activity](/graph/api/resources/yammer-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | -| [Yammer device usage](/graph/api/resources/yammer-device-usage-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | -| [Yammer groups activity](/graph/api/resources/yammer-groups-activity-reports?view=graph-rest-beta&preserve-view=true) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | +| [Admin report settings](../resources/adminreportsettings.md) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [Microsoft 365 activations](../resources/reportroot.md#microsoft-365-activations) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | +| [Microsoft 365 active users](../resources/reportroot.md#microsoft-365-active-users)| Γ£ö | Γ£ö | Γ£ö | Γ₧û | +| [Microsoft 365 Apps usage](../resources/reportroot.md#microsoft-365-apps-usage) | Γ£ö | Γ£ö | Γ£ö | Γ₧û | +| [Microsoft 365 browser usage](../resources/reportroot.md#microsoft-365-browser-usage) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | +| [Microsoft 365 groups activity](../resources/reportroot.md#microsoft-365-groups-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | +| [Microsoft Forms Usage](../resources/reportroot.md#forms-activity) | Γ£ö | Γ₧û | +| [Microsoft Teams device usage](../resources/reportroot.md#microsoft-teams-device-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [Microsoft Teams team activity](../resources/reportroot.md#microsoft-teams-team-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [Microsoft Teams user activity](../resources/reportroot.md#microsoft-teams-user-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [Outlook activity](../resources/reportroot.md#outlook-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [Outlook app usage](../resources/reportroot.md#outlook-app-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [Outlook mailbox usage](../resources/reportroot.md#outlook-mailbox-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [OneDrive activity](../resources/reportroot.md#onedrive-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [OneDrive usage](../resources/reportroot.md#onedrive-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [SharePoint activity](../resources/reportroot.md#sharepoint-activity) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [SharePoint site usage](../resources/reportroot.md#sharepoint-site-usage) | Γ£ö | Γ£ö | Γ£ö | Γ£ö | +| [Skype for Business activity](../resources/reportroot.md#skype-for-business-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | +| [Skype for Business device usage](../resources/reportroot.md#skype-for-business-device-usage) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | +| [Skype for Business organizer activity](../resources/reportroot.md#skype-for-business-organizer-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | +| [Skype for Business participant activity](../resources/reportroot.md#skype-for-business-participant-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | +| [Skype for Business peer-to-peer activity](../resources/reportroot.md#skype-for-business-peer-to-peer-activity) | Γ£ö | Γ₧û | Γ£ö | Γ₧û | +| [Viva Engage activity](../resources/reportroot.md#viva-engage-activity) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | +| [Viva Engage device usage](../resources/reportroot.md#viva-engage-device-usage) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | +| [Viva Engage groups activity](../resources/reportroot.md#viva-engage-groups-activity) | Γ£ö | Γ₧û | Γ₧û | Γ₧û | ## Next steps |
v1.0 | Security Alert | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/security-alert.md | Security providers create an alert in the system when they detect a threat. Micr |detectionSource|[microsoft.graph.security.detectionSource](#detectionsource-values)| Detection technology or sensor that identified the notable component or activity. Possible values are: `unknown`, `microsoftDefenderForEndpoint`, `antivirus`, `smartScreen`, `customTi`, `microsoftDefenderForOffice365`, `automatedInvestigation`, `microsoftThreatExperts`, `customDetection`, `microsoftDefenderForIdentity`, `cloudAppSecurity`, `microsoft365Defender`, `azureAdIdentityProtection`, `manual`, `microsoftDataLossPrevention`, `appGovernancePolicy`, `appGovernanceDetection`, `unknownFutureValue`, `microsoftDefenderForCloud`, `microsoftDefenderForIoT`, `microsoftDefenderForServers`, `microsoftDefenderForStorage`, `microsoftDefenderForDNS`, `microsoftDefenderForDatabases`, `microsoftDefenderForContainers`, `microsoftDefenderForNetwork`, `microsoftDefenderForAppService`, `microsoftDefenderForKeyVault`, `microsoftDefenderForResourceManager`, `microsoftDefenderForApiManagement`, `microsoftSentinel`, `nrtAlerts`, `scheduledAlerts`, `microsoftDefenderThreatIntelligenceAnalytics`, `builtInMl`. You must use the `Prefer: include-unknown-enum-members` request header to get the following value(s) in this [evolvable enum](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations): `microsoftDefenderForCloud`, `microsoftDefenderForIoT`, `microsoftDefenderForServers`, `microsoftDefenderForStorage`, `microsoftDefenderForDNS`, `microsoftDefenderForDatabases`, `microsoftDefenderForContainers`, `microsoftDefenderForNetwork`, `microsoftDefenderForAppService`, `microsoftDefenderForKeyVault`, `microsoftDefenderForResourceManager`, `microsoftDefenderForApiManagement`, `microsoftSentinel`, `nrtAlerts`, `scheduledAlerts`, `microsoftDefenderThreatIntelligenceAnalytics`, `builtInMl`.| |detectorId|String| The ID of the detector that triggered the alert.| |productName|String| The name of the product which published this alert.|-|determination|[microsoft.graph.security.alertDetermination](#alertdetermination-values)| Specifies the result of the investigation, whether the alert represents a true attack, and if so, the nature of the attack. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedUser`, `phishing`, `maliciousUserActivity`, `clean`, `insufficientData`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.| +|determination|[microsoft.graph.security.alertDetermination](#alertdetermination-values)| Specifies the result of the investigation, whether the alert represents a true attack, and if so, the nature of the attack. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedAccount`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.| |evidence|[microsoft.graph.security.alertEvidence](security-alertEvidence.md) collection| Collection of evidence related to the alert.| |firstActivityDateTime|DateTimeOffset| The earliest activity associated with the alert.| |id|String| Unique identifier to represent the **alert** resource.| Security providers create an alert in the system when they detect a threat. Micr | securityPersonnel | A true positive alert that detected valid suspicious activity performed by someone on the customer's security team. | | securityTesting | The alert detected valid suspicious activity that was performed as part of a known security testing. | | unwantedSoftware | The alert detected unwanted software. |+| other | Other determination. | | multiStagedAttack | A true positive alert that detected multiple kill-chain attack stages. | | compromisedAccount | A true positive alert that detected that the intended user's credentials were compromised or stolen. | | phishing | A true positive alert that detected a phishing email. | Security providers create an alert in the system when they detect a threat. Micr | notEnoughDataToValidate | A false alert, without enough information to prove otherwise. | | confirmedActivity | The alert caught a true suspicious activity that is considered OK because it's a known user activity. | | lineOfBusinessApplication | The alert caught a true suspicious activity that is considered OK because it's a known and confirmed internal application. |-| other | Other determination. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ### alertSeverity values |
v1.0 | Tasks Overview | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/tasks-overview.md | +toc. Title: To-do tasks API overview (deprecated) # Use the To Do API built on base tasks in Microsoft Graph (deprecated) |
v1.0 | Teamwork | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/teamwork.md | Inherits from [entity](../resources/entity.md). |:|:|:| |id|string|The default teamwork identifier.| |isTeamsEnabled|Boolean|Indicates whether Microsoft Teams is enabled for the organization.| -|region|string|Represents the region of the organization or the tenant. The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israe`l, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.| +|region|string|Represents the region of the organization or the tenant. The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israel`, `Spain`, `Mexico`, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.| ## Relationships | Relationship | Type | Description | |
v1.0 | User | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/user.md | For example, Cameron is an administrator of a directory for an elementary school |scopedRoleMemberOf|[scopedRoleMembership](scopedrolemembership.md) collection| The scoped-role administrative unit memberships for this user. Read-only. Nullable.| |security|[security](security.md) |Nullable.| |settings|[userSettings](usersettings.md) | Read-only. Nullable.|+|solutions|[userSolutionRoot](../resources/usersolutionroot.md)| Represents a user's custom solution entity. Read-Only. Nullable.| |sponsors|[directoryObject](../resources/directoryobject.md) collection|The users and groups responsible for this guest user's privileges in the tenant and keep the guest user's information and access updated. (HTTP Methods: GET, POST, DELETE.). Supports `$expand`.| |teamwork|[userTeamwork](userteamwork.md)| A container for Microsoft Teams features available for the user. Read-only. Nullable.| |todo|[todo](todo.md)|Represents the To Do services available to a user. | |
v1.0 | Usersolutionroot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/usersolutionroot.md | + + Title: "userSolutionRoot resource type" +description: "Represents a user's custom userSolutionRoot entity." ++ms.localizationpriority: medium ++++# userSolutionRoot resource type ++Namespace: microsoft.graph +++Represents a user's custom solution entity. ++## Properties ++|Property|Type|Description| +|:|:|:| +|id|String|A unique programmatic identifier for the entity. Read-only.| ++## Relationships ++|Relationship|Type|Description| +|:|:|:| +|workingTimeSchedule|[workingTimeSchedule](../resources/workingtimeschedule.md)|The working time schedule entity associated with the solution.| ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.userSolutionRoot", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.userSolutionRoot", + "id": "String (identifier)" +} +``` |
v1.0 | Userteamwork | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/userteamwork.md | Represents a container for the range of Microsoft Teams functionalities that are |:|:--|:-| |id| String|The unique identifier for the **userTeamwork** object.| |locale|String |Represents the location that a user selected in Microsoft Teams and doesn't follow the Office's locale setting. A userΓÇÖs locale is represented by their preferred language and country or region. For example, `en-us`. The language component follows two-letter codes as defined in [ISO 639-1](https://www.iso.org/iso/home/standards/language_codes.htm), and the country component follows two-letter codes as defined in [ISO 3166-1 alpha-2](https://www.iso.org/iso/country_codes.htm).| -|region|string|Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user's region (if available). For users without multigeo licenses, the property contains the organization's region.<br><br>The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israe`l, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.| +|region|string|Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user's region (if available). For users without multigeo licenses, the property contains the organization's region.<br><br>The **region** value can be any region supported by the Teams payload. The possible values are: `Americas`, `Europe and MiddleEast`, `Asia Pacific`, `UAE`, `Australia`, `Brazil`, `Canada`, `Switzerland`, `Germany`, `France`, `India`, `Japan`, `South Korea`, `Norway`, `Singapore`, `United Kingdom`, `South Africa`, `Sweden`, `Qatar`, `Poland`, `Italy`, `Israel`, `Spain`, `Mexico`, `USGov Community Cloud`, `USGov Community Cloud High`, `USGov Department of Defense`, and `China`.| ## Relationships |
v1.0 | Virtualeventsession | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/virtualeventsession.md | Namespace: microsoft.graph Represents a session in a [virtualEvent](../resources/virtualevent.md). -Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md). +Inherits from [onlineMeetingBase](../resources/onlinemeetingbase.md). ## Methods Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md). | Property | Type | Description | | :-- | :-- | : |-| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowParticipantsToChangeName | Boolean | Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowTranscription | Boolean | Indicates whether transcription is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowRecording | Boolean | Indicates whether recording is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the virtual event session. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md).| -| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| allowAttendeeToEnableCamera | Boolean | Indicates whether attendees can turn on their camera. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowAttendeeToEnableMic | Boolean | Indicates whether attendees can turn on their microphone. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowBreakoutRooms | Boolean | Indicates whether breakout rooms are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowedPresenters | [onlineMeetingPresenters](#onlinemeetingpresenters-values)| Specifies who can be a presenter in a virtual event session. Possible values are: `everyone`, `organization`, `roleIsPresenter`, `organizer`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowLiveShare | [meetingLiveShareOptions](#meetingliveshareoptions-values) | Indicates whether live share is enabled for the virtual event session. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowMeetingChat | [meetingChatMode](#meetingchatmode-values) | Specifies the mode of meeting chat. Possible values are: `enabled`, `disabled`, `limited`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowParticipantsToChangeName | Boolean | Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowPowerPointSharing | Boolean | Indicates whether PowerPoint live is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowRecording | Boolean | Indicates whether recording is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowTeamworkReactions | Boolean | Indicates whether Teams reactions are enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowTranscription | Boolean | Indicates whether transcription is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| allowWhiteboard | Boolean | Indicates whether whiteboard is enabled for the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| anonymizeIdentityForRoles | onlineMeetingRole collection | Specifies whose identity is anonymized in the virtual event session. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md).| +| audioConferencing | [audioConferencing](audioconferencing.md) | The phone access (dial-in) information for the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| chatInfo | [chatInfo](chatinfo.md) | The chat information associated with the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | endDateTime | [DateTimeTimeZone](../resources/datetimetimezone.md) | The virtual event session end time. |-| id | String | The unique identifier of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinInformation | [itemBody](itembody.md) | The join information of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| joinWebUrl | String | The join URL of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| recordAutomatically | Boolean | Indicates whether to record the virtual event session automatically. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| id | String | The unique identifier of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| isEntryExitAnnounced | Boolean | Indicates whether to announce when callers join or leave. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinInformation | [itemBody](itembody.md) | The join information of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinMeetingIdSettings | [joinMeetingIdSettings](joinmeetingidsettings.md) | Specifies the **joinMeetingId**, the meeting passcode, and the requirement for the passcode. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| joinWebUrl | String | The join URL of the virtual event session. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| lobbyBypassSettings | [lobbyBypassSettings](lobbyBypassSettings.md) | Specifies which participants can bypass the meeting lobby. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| recordAutomatically | Boolean | Indicates whether to record the virtual event session automatically. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| shareMeetingChatHistoryDefault | [meetingChatHistoryDefaultMode](#meetingchathistorydefaultmode-values) | Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | | startDateTime | [DateTimeTimeZone](../resources/datetimetimezone.md) | The virtual event session start time. |-| subject | String | The subject of the virtual event session. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | -| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlineMeetingBase.md). | +| subject | String | The subject of the virtual event session. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| videoTeleconferenceId | String | The video teleconferencing ID. Read-only. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | +| watermarkProtection | [watermarkProtectionValues](watermarkprotectionvalues.md) | Specifies whether the client application should apply a watermark to a content type. Inherited from [onlineMeetingBase](../resources/onlinemeetingbase.md). | -### onlineMeetingPresenters values +### meetingChatHistoryDefaultMode values -| Value | Description | -| | - | -| everyone | Everyone is a presenter. Default. | -| organization | Everyone in organizerΓÇÖs organization is a presenter. | -| roleIsPresenter | Only the participants whose role is presenter are presenters. | -| organizer | Only the organizer is a presenter. | -| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +| Value | Description | +| | - | +| all | All meeting chat history is shared. | +| none | No meeting chat history is shared. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ### meetingChatMode values Inherits from [onlineMeetingBase](../resources/onlinemeetingBase.md). | | - | | enabled | Meeting chat is enabled. | | disabled | Meeting chat is disabled. |-| limited | Meeting chat is enabled but only during the meeting call. | +| limited | Meeting chat is enabled but only during the meeting call. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | -### meetingChatHistoryDefaultMode values +### meetingLiveShareOptions values | Value | Description | | | - |-| all | All meeting chat history is shared. | -| none | No meeting chat history is shared. | +| enabled | Meeting live share is enabled. | +| disabled | Meeting live share is disabled. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | +### onlineMeetingPresenters values ++| Value | Description | +| | - | +| everyone | Everyone is a presenter. Default. | +| organization | Everyone in organizerΓÇÖs organization is a presenter. | +| roleIsPresenter | Only the participants whose role is presenter are presenters. | +| organizer | Only the organizer is a presenter. | +| unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | + ## Relationships |Relationship|Type|Description| The following JSON representation shows the resource type. "@odata.type": "#microsoft.graph.virtualEventSession", "allowAttendeeToEnableCamera": "Boolean", "allowAttendeeToEnableMic": "Boolean",+ "allowBreakoutRooms": "Boolean", + "allowedPresenters": "String", + "allowLiveShare": "String", "allowMeetingChat": "String", "allowParticipantsToChangeName": "Boolean",+ "allowPowerPointSharing": "Boolean", + "allowRecording": "Boolean", "allowTeamworkReactions": "Boolean",- "allowedPresenters": "String", + "allowTranscription": "Boolean", + "allowWhiteboard": "Boolean", "anonymizeIdentityForRoles": ["String"], "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"}, "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"}, |
v1.0 | Workforceintegrationencryption | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workforceintegrationencryption.md | An encryption entity defining the protocol and secret for a [workforceintegratio |protocol|String| Possible values are: `sharedSecret`, `unknownFutureValue`.| |secret|String|Encryption shared secret.| +## Relationships ++None. + ## JSON representation -HEre's a JSON representation of the resource. +The following JSON representation shows the resource type. <!-- { "blockType": "resource", |
v1.0 | Workingtimeschedule | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workingtimeschedule.md | + + Title: "workingTimeSchedule resource type" +description: "Represents a user's scheduled working hours." ++ms.localizationpriority: medium ++++# workingTimeSchedule resource type ++Namespace: microsoft.graph +++Represents a user's scheduled working hours. ++## Methods ++|Method|Return type|Description| +|:|:|:| +|[Get](../api/workingtimeschedule-get.md)|[workingTimeSchedule](../resources/workingtimeschedule.md)|Read the properties and relationships of a [workingTimeSchedule](../resources/workingtimeschedule.md) object.| +|[Start working time](../api/workingtimeschedule-startworkingtime.md)|None|Trigger the policies associated with the start of working hours for a specific user.| +|[End working time](../api/workingtimeschedule-endworkingtime.md)|None|Trigger the policies associated with the end of working hours for a specific user.| ++## Properties ++|Property|Type|Description| +|:|:|:| +|id|String|A unique programmatic identifier for the entity. Read-only.| ++## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.workingTimeSchedule", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.workingTimeSchedule", + "id": "String (identifier)" +} +``` |
v1.0 | Workplacesensor | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensor.md | Represents a sensor on hardware that collects and reports data on physical or en |displayName|String|The display name of the sensor. Optional.| |placeId|String| The unique identifier of the place that the sensor detects. If the device is installed in a room equipped with a mailbox, this property should match the **ExternalDirectoryObjectId** or Microsoft Entra object ID of the room mailbox. If the sensor detects the same place as the location of the device, the property can be omitted. The default value is the place identifier of the device. Optional. | |sensorId|String| The user-defined unique identifier of the sensor on the device. If the device has multiple sensors of the same type, the property must be provided to identify each sensor. If the device has only one sensor of a type, the property can be omitted. The default value is the sensor type. Optional. |-|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)|The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `bagde`, `wifi`, `unknownFutureValue`. Required. | +|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)|The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `badge`, `unknownFutureValue`. Required. | ### workplaceSensorType values Represents a sensor on hardware that collects and reports data on physical or en | inferredOccupancy | The sensor estimates the occupancy status of the place based on other clues, such as the presence of a laptop or a backpack. Use it for sensors that don't directly detect motion or people count. | | heartbeat | The sensor reports the heartbeat of the device. It indicates if the device is online or not. Use it for sensors that monitor the status of the device. | | badge | The sensor reports badge-swiping events of the people. Use it for sensors that accept active user interactions. |-| wifi | The sensor reports the device's Wi-Fi connection and disconnects events from people. Use it for sensors that connect to other devices with Wi-Fi. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ## Relationships |
v1.0 | Workplacesensordevicetelemetry | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensordevicetelemetry.md | Represents the data collected and reported by a sensor on a device, such as occu |deviceId|String|The user-defined unique identifier of the device provided at the time of creation. Don't use the system generated identifier of the device.| |intValue|Int32|The value of the sensor as an integer. Use it for sensors that report numerical values, such as people count. | |sensorId|String|The user-defined unique identifier of the sensor on the device. Optional. If the device has multiple sensors of the same type, the property must be provided to identify each sensor. If the device has unique sensor types, the property can be omitted. The default value is the sensor type.|-|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)| The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `badge`, `wifi`, `unknownFutureValue`.| +|sensorType|[workplaceSensorType](../resources/workplacesensor.md#workplacesensortype-values)| The type of sensor. The possible values are: `occupancy`, `peopleCount`, `inferredOccupancy`, `heartbeat`, `badge`, `unknownFutureValue`.| |timestamp|DateTimeOffset|The date and time when the sensor measured and reported its value. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. |-|eventValue| [workplaceSensorEventValue](../resources/workplacesensoreventvalue.md)| The extra values associated with badge and Wi-Fi signals. | +|eventValue| [workplaceSensorEventValue](../resources/workplacesensoreventvalue.md)| The extra values associated with badge signals. | |locationHint|String|The additional information to indicate the location of the device. | ## Relationships |
v1.0 | Workplacesensoreventvalue | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/beta/resources/workplacesensoreventvalue.md | Title: "workplaceSensorEventValue resource type" -description: "Represents the data collected and reported by a Wi-Fi or badge-swiping device." +description: "Represents the data collected and reported by a badge-swiping device." ms.localizationpriority: medium Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents the data collected and reported by a Wi-Fi or badge-swiping device. +Represents the data collected and reported by a badge-swiping device. ## Properties | Property | Type | Description | |:|:--|:|-| eventType | [workplaceSensorEventType](../resources/workplacesensoreventvalue.md#workplacesensoreventtype-values) | The type of possible sensor event value. The possible values are: `badgeIn`, `badgeOut`, `wifiConnect`, `wifiDisconnect`, `unknownFutureValue`. | +| eventType | [workplaceSensorEventType](../resources/workplacesensoreventvalue.md#workplacesensoreventtype-values) | The type of possible sensor event value. The possible values are: `badgeIn`, `badgeOut`, `unknownFutureValue`. | | user | [emailIdentity](../resources/emailidentity.md) | The unique identifier of a user. It could be an email or a Microsoft Entra ID. | ### workplaceSensorEventType values Represents the data collected and reported by a Wi-Fi or badge-swiping device. |:-|:| | badgeIn | An event in which a user enters a place by swiping the badge. | | badgeOut | An event in which a user exits a place by swiping the badge. |-| wifiConnect | An event in which a user connects to the Wi-Fi device. | -| wifiDisconnect | An event in which a user disconnects from the Wi-Fi device. | | unknownFutureValue | Evolvable enumeration sentinel value. Don't use. | ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Accesspackageassignmentrequest Resume | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 doc_type: "apiPageType" Namespace: microsoft.graph -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-only.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 <!-- { If successful, this action returns a `204 No Content` response code. #### Request -The following is an example of a call to resume an access package assignment request that's waiting for a callback. +The following example shows a request of a call to resume an access package assignment request that's waiting for a callback. # [HTTP](#tab/http) <!-- { HTTP/1.1 204 No Content #### Request -The following is an example to resume the processing of an access package assignment request by denying the request that's waiting for a callback. A request cannot be denied at the `assignmentRequestCreated` stage of the callout. +The following example shows a request to resume the processing of an access package assignment request by denying the request that's waiting for a callback. A request cannot be denied at the `assignmentRequestCreated` stage of the callout. <!-- { "blockType": "request" } |
v1.0 | Adminreportsettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/adminreportsettings-get.md | + + Title: "Get adminReportSettings" +description: "Get the tenant-level settings for Microsoft 365 reports." +ms.localizationpriority: medium +++++# Get adminReportSettings ++Namespace: microsoft.graph ++Get the tenant-level settings for Microsoft 365 reports. ++> **Note:** For details about different report views and names, see [Microsoft 365 Reports in the admin center - Microsoft 365 Apps usage](/microsoft-365/admin/activity-reports/microsoft365-apps-usage). +++## 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": "adminreportsettings_get" } --> ++> **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 ++<!-- { "blockType": "ignored" } --> ++```http +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 | +| : | : | +|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 an [adminReportSettings](../resources/adminreportsettings.md) object in the response body. ++## Examples ++### Request ++The following example shows a request. ++<!-- { + "blockType": "request", + "name": "get_adminreportsettings" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/admin/reportSettings +``` ++### 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.adminReportSettings" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": { + "@odata.type": "#microsoft.graph.adminReportSettings", + "displayConcealedNames": true + } +} +``` |
v1.0 | Adminreportsettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/adminreportsettings-update.md | + + Title: "Update adminReportSettings" +description: "Update tenant-level settings for Microsoft 365 reports." +ms.localizationpriority: medium +++++# Update adminReportSettings ++Namespace: microsoft.graph ++Update tenant-level settings for Microsoft 365 reports. +++## 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": "adminreportsettings_update" } --> ++> **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" } --> +```http +PATCH /admin/reportSettings +``` ++## 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 +++| Property | Type | Description | +| -- | -- | - | +| 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 ++If successful, this method returns a `204 No Content` response code. ++## Examples ++The following example shows a request that updates a tenant-level setting for Microsoft 365 reports. ++### Request +The following example shows a request. ++<!-- { + "blockType": "request", + "name": "update_adminreportsettings" +} +--> +``` http +PATCH https://graph.microsoft.com/v1.0/admin/reportSettings +Content-Type: application/json +Content-length: 37 ++{ + "displayConcealedNames": true +} +``` ++### Response ++The following example shows the response. ++<!-- { + "blockType": "response" +} --> +```http +HTTP/1.1 204 No Content +``` |
v1.0 | Application List Owners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 -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 <!-- { "blockType": "permissions", "name": "application_list_owners" } --> [!INCLUDE [permissions-table](../includes/permissions/application-list-owners-permissions.md)] - ## HTTP request 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 a 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) The following example shows a request. "name": "application_get_owners" }--> ```msgraph-interactive-GET https://graph.microsoft.com/v1.0/applications/acc848e9-e8ec-4feb-a521-8d58b5482e09/owners +GET https://graph.microsoft.com/v1.0/applications(appId='bbec3106-565f-4907-941e-96b4dbfef21c')/owners ``` # [C#](#tab/csharp) GET https://graph.microsoft.com/v1.0/applications/acc848e9-e8ec-4feb-a521-8d58b5 -##### Response -The following example shows the response. +### 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. <!-- { HTTP/1.1 200 OK Content-type: application/json {- "value": [ - { - "id": "id-value" - } - ] + "@odata.context": "https://graph.microsoft.com/v1.0/$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/v1.0/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 will need to [register the calling bot](/microsoftteams/platform/concepts/calls-and-meetings/registering-calling-bot) and go through the list of permissions needed as mentioned below. +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-us.md)] ## Permissions |
v1.0 | Applicationtemplate Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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 | Authenticationconditionapplication Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationconditionapplication-delete.md | DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c [!INCLUDE [sample-code](../includes/snippets/php/delete-includeapplications-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/delete-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Authenticationconditionsapplications List Includeapplications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationconditionsapplications-list-includeapplications.md | GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37 [!INCLUDE [sample-code](../includes/snippets/php/get-includeapplications-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-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Authenticationconditionsapplications Post Includeapplications | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationconditionsapplications-post-includeapplications.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/post-includeapplications-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/post-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Authenticationeventsflow Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventsflow-delete.md | DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c [!INCLUDE [sample-code](../includes/snippets/php/delete-authenticationeventsflow-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/delete-authenticationeventsflow-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Authenticationeventsflow Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventsflow-get.md | GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37 [!INCLUDE [sample-code](../includes/snippets/php/get-authenticationeventsflow-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-authenticationeventsflow-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Authenticationeventsflow Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/authenticationeventsflow-update.md | You must include the **@odata.type** property with a value of the specific user |conditions|[authenticationConditions](../resources/authenticationconditions.md)|The conditions representing the context of the authentication request that is used to decide whether the events policy is invoked. | |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 Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/authenticationeventsflow-update-beta-e1-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/authenticationeventsflow-update-beta-e1-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] The following example shows the response. HTTP/1.1 204 No Content ``` -### Example 2: Update the onAttributeCollection event of an external identities 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're 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" + } + ] } ] } Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-authenticationeventsflow-onattributecollection-beta-e2-php-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] -# [Python](#tab/python) ----#### Response --The following example shows the response. -<!-- { - "blockType": "response", - "truncated": true -} >-``` http -HTTP/1.1 204 No Content -``` --### Example 3: Remove an attribute collected during an external identities 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/v1.0/identity/authenticationEventsFlows/0313cc37-d421-421d-857b-87804d61e33e -Content-Type: application/json --{ - "@odata.type": "#microsoft.graph.externalUsersSelfServiceSignUpEventsFlow", - "onAttributeCollection": { - "@odata.type": "#microsoft.graph.onAttributeCollectionExternalUsersSelfServiceSignUp", - "attributeCollectionPage": { - "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) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] # [Python](#tab/python) [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] The following example shows the response. ``` http HTTP/1.1 204 No Content ```- |
v1.0 | Basesitepage Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/basesitepage-delete.md | DELETE /sites/{site-id}/pages/{page-id} | Name | Value | Description |:--|:|:---|Authorization|Bearer {token}.| Required| +|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| Required| | _if-match_ | etag | If this request header is included and the eTag provided doesn't match the current tag on the item, a `412 Precondition Failed` response is returned and the item won't be deleted. ## Request body |
v1.0 | Bookingappointment Cancel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/api/bookingappointment-get.md | This method supports the `$count` and `$expand` [OData query parameters](/graph/ | 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/v1.0/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/v1.0/api/bookingbusiness-get.md | This method supports the `$count` [OData query parameter](/graph/query-parameter | 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/v1.0/api/bookingbusiness-list-calendarview.md | This method also supports some of the `$count` and `$expand` [OData query parame | 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 Customers | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingbusiness-list-customers.md | This method supports the $count and $expand [OData query parameters](/graph/quer ## 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/v1.0/api/bookingbusiness-list.md | This method also supports the `query` parameter which accepts a string value. Th | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingbusiness Post Bookingbusinesses | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 a [bookingBusiness](../resources/bookingbusiness.md) object. |
v1.0 | Bookingbusiness Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/api/bookingbusiness-update.md | PATCH /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 [!INCLUDE [table-intro](../../includes/update-property-table-intro.md)] |
v1.0 | Bookingcurrency Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/bookingcurrency-get.md | This method supports the $count and $expand [OData query parameters](/graph/quer ## 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/v1.0/api/bookingcurrency-list.md | This method supports the $count and $expand [OData query parameters](/graph/quer ## 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/v1.0/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/v1.0/api/bookingcustomer-get.md | This method supports the $count and $expand [OData query parameters](/graph/quer | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Bookingcustomer Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 |
v1.0 | Bookingservice Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/api/bookingstaffmember-get.md | This method supports the $count and $expand [OData query parameters](/graph/quer | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Call Answer | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/call-answer.md | doc_type: apiPageType Namespace: microsoft.graph -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 will contain 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 will contain 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 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-us.md)] ## Permissions The following example shows how to call this API. #### Request The following example shows the request. - # [HTTP](#tab/http) <!-- { "blockType": "request", Content-Type: application/json #### Request - # [HTTP](#tab/http) <!-- { "blockType": "request", Content-Type: application/json #### Request - # [HTTP](#tab/http) <!-- { "blockType": "request", |
v1.0 | Callrecords Callrecord List Participants_V2 | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/callrecords-callrecord-list-participants_v2.md | This method supports the following OData query parameter to help customize the r | Name |Description| |:-|:-|-| Authorization | Bearer {token} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| | Prefer: odata.maxpagesize={x} | Specifies a preferred integer {x} page size for paginated results. This value must be equal to or less than the maximum allowable page size. Optional. | | Prefer: include-unknown-enum-members | Enables evolvable enum values beyond the sentinel value. For more information, see [Best practices for working with Microsoft Graph](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). Optional. | | Prefer: omit-values=nulls | Removes null or empty values from the response. Optional. | |
v1.0 | Callrecords Cloudcommunications List Callrecords | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/callrecords-cloudcommunications-list-callrecords.md | This method supports the following OData query parameters to help customize the | Name |Description| |:-|:-|-| Authorization | Bearer {token} | +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| | Prefer: odata.maxpagesize={x} | Specifies a preferred integer {x} page size for paginated results. This value must be equal to or less than the maximum allowable page size. Optional. | | Prefer: include-unknown-enum-members | Enables evolvable enum values beyond the sentinel value. For more information, see [Best practices for working with Microsoft Graph](/graph/best-practices-concept#handling-future-members-in-evolvable-enumerations). Optional. | | Prefer: omit-values=nulls | Removes null or empty values from the response. Optional. | |
v1.0 | Calltranscript Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/me/onlineMeetings/MSoxMjczYTAxNi0yMDFkLTRmOTUtODA4My0xYjdmOTliM2VkZWIqMCoqMTk6bWVldGluZ19OV1EwWm1GbFpEY3RORFJqTmkwMFlXRm1MV0U1WXpBdE9UZzJNMk0yTm1Nd1pERTNAdGhyZWFkLnYy/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 Archive | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-archive.md | POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721 [!INCLUDE [sample-code](../includes/snippets/php/archive-channel-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/archive-channel-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721 [!INCLUDE [sample-code](../includes/snippets/php/archive-channel-on-archived-team-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/archive-channel-on-archived-team-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Channel Unarchive | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/channel-unarchive.md | POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721 [!INCLUDE [sample-code](../includes/snippets/php/unarchive-channel-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/unarchive-channel-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] POST https://graph.microsoft.com/v1.0/teams/16dc05c0-2259-4540-a970-3580ff459721 [!INCLUDE [sample-code](../includes/snippets/php/unarchive-channel-on-archived-team-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/unarchive-channel-on-archived-team-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Chatmessage List Hostedcontents | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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 | Directoryaudit Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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 | Driveitem Getretentionlabel | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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/v1.0/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 | Identitycontainer List Authenticationeventsflows | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/identitycontainer-list-authenticationeventsflows.md | GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows [!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-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/list-authenticationeventsflow-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows?$filter= [!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-selfservicesignup-identityproviders-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/list-authenticationeventsflow-selfservicesignup-identityproviders-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows?$filter= [!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-filter-selfservicesignup-attributes-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/list-authenticationeventsflow-filter-selfservicesignup-attributes-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows?$filter= [!INCLUDE [sample-code](../includes/snippets/php/list-authenticationeventsflow-filter-includeapplications-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/list-authenticationeventsflow-filter-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Identitycontainer List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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/v1.0/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/v1.0/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 Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-authenticationeventsflow-selfservicesignup-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/create-authenticationeventsflow-selfservicesignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-authenticationeventsflow-selfservicesignup-includeapplications-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/create-authenticationeventsflow-selfservicesignup-includeapplications-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/create-authenticationeventsflow--selfservicesignup-socialproviders-customattribute-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/create-authenticationeventsflow--selfservicesignup-socialproviders-customattribute-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Identitygovernance Deleteditemcontainer Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/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 | Multitenantorganization Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/multitenantorganization-update.md | Content-Type: application/json [!INCLUDE [sample-code](../includes/snippets/php/update-multitenantorganization-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/update-multitenantorganization-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Notebook Getrecentnotebooks | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/notebook-getrecentnotebooks.md | The `{id | userPrincipalName}` for the user must match the user encoded in the a ## 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 | Onattributecollectionexternalusersselfservicesignup Delete Attributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onattributecollectionexternalusersselfservicesignup-delete-attributes.md | doc_type: apiPageType # Remove attribute (from user flow) Namespace: microsoft.graph - Remove an attribute from an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow. -After this step, [PATCH the user flow](../api/authenticationeventsflow-update.md) to remove the attribute from the attribute collection step. +The attribute is removed from both the **onAttributeCollection** > **attributes** and **onAttributeCollection** > **attributeCollectionPage** > **views** collections of the user flow. ++This API operation fails when you attempt to remove the last remaining attribute on the user flow. ## 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). Don't supply a request body for this method. ## Response -If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details. +If successful, this method returns a `204 No Content` response code. If unsuccessful, a `4xx` error is returned with specific details. Attempting to remove the last remaining attribute results in a `400 Bad Request` error code. ## Examples #### Request-The following example shows a request that removes city as an attribute from the attribute collection step of an external identities self-service sign-up user flow. After executing this step, [update the attributes collected in the userflow](../api/authenticationeventsflow-update.md). +The following example shows a request that removes city as an attribute from the attribute collection step of an external identities self-service sign-up user flow. # [HTTP](#tab/http) <!-- { "blockType": "request", DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c [!INCLUDE [sample-code](../includes/snippets/php/delete-onattributecollectionexternalusersselfservicesignup-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/delete-onattributecollectionexternalusersselfservicesignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Onattributecollectionexternalusersselfservicesignup List Attributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onattributecollectionexternalusersselfservicesignup-list-attributes.md | GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37 [!INCLUDE [sample-code](../includes/snippets/php/get-onattributecollectionexternalusersselfservicesignup-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-onattributecollectionexternalusersselfservicesignup-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Onattributecollectionexternalusersselfservicesignup Post Attributes | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onattributecollectionexternalusersselfservicesignup-post-attributes.md | doc_type: apiPageType # Add attribute (to user flow) Namespace: microsoft.graph -Add an attribute to an external identities self-service user flow represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow. +Add an attribute to an external identities self-service sign up user flow that's represented by an [externalUsersSelfServiceSignupEventsFlow](../resources/externalusersselfservicesignupeventsflow.md) object. You can add both custom and built-in attributes to a user flow. -Prerequisite: [PATCH the user flow](../api/authenticationeventsflow-update.md) with the updated onAttributeCollection event that includes the new attribute. +The attribute is added to both the **attributeCollection**> **attributes** and **attributeCollection**> **attributeCollectionPage** > **views** collections on the user flow. In the **views** collection, the attribute is assigned the default settings. You can [PATCH the user flow](../api/authenticationeventsflow-update.md) to customize the settings of the attribute on the **views** object, for example, marking it as required or updating the allowed input types. ## 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). If successful, this method returns a `204 No Content` response code. If unsucces #### Request -The following example shows a request that adds city as an attribute for attribute collection step of an external identities self-service sign-up user flow. Before you can add an attribute to the attribute collection step, you must first [add it among the attributes to be collected in the user flow](../api/authenticationeventsflow-update.md). +The following example shows a request that adds city as an attribute for attribute collection step of an external identities self-service sign-up user flow. If the request is successful, the attribute is added to both the **attributeCollection**> **attributes** and **attributeCollection**> **attributeCollectionPage** > **views** collections on the user flow. After adding the attribute to the user flow, you can [PATCH the user flow](../api/authenticationeventsflow-update.md) to customize the settings of the attribute on the **views** object, that is, customize the page layout. # [HTTP](#tab/http) <!-- { POST https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc3 [!INCLUDE [sample-code](../includes/snippets/php/onattributecollectionexternalusersselfservicesignup-post-attributes-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/onattributecollectionexternalusersselfservicesignup-post-attributes-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Onauthenticationmethodloadstartexternalusersselfservicesignup Delete Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onauthenticationmethodloadstartexternalusersselfservicesignup-delete-identityproviders.md | DELETE https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313c [!INCLUDE [sample-code](../includes/snippets/php/delete-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-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/delete-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Onauthenticationmethodloadstartexternalusersselfservicesignup List Identityproviders | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/onauthenticationmethodloadstartexternalusersselfservicesignup-list-identityproviders.md | GET https://graph.microsoft.com/v1.0/identity/authenticationEventsFlows/0313cc37 [!INCLUDE [sample-code](../includes/snippets/php/list-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-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/list-onauthenticationmethodloadstartexternalusersselfservicesignup-identityproviders-python-snippets.md)] [!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)] |
v1.0 | Security Incident Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/security-incident-update.md | PATCH /security/incidents/{incidentId} |assignedTo|String|Owner of the incident, or null if no owner is assigned. Free editable text.| |classification|microsoft.graph.security.alertClassification|The specification for the incident. Possible values are: `unknown`, `falsePositive`, `truePositive`, `informationalExpectedActivity`, `unknownFutureValue`.| |customTags|String collection|Array of custom tags associated with an incident.|-|determination|microsoft.graph.security.alertDetermination|Specifies the determination of the incident. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedUser`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.| +|determination|microsoft.graph.security.alertDetermination|Specifies the determination of the incident. Possible values are: `unknown`, `apt`, `malware`, `securityPersonnel`, `securityTesting`, `unwantedSoftware`, `other`, `multiStagedAttack`, `compromisedAccount`, `phishing`, `maliciousUserActivity`, `notMalicious`, `notEnoughDataToValidate`, `confirmedUserActivity`, `lineOfBusinessApplication`, `unknownFutureValue`.| |status|microsoft.graph.security.incidentStatus|The status of the incident. Possible values are: `active`, `resolved`, `redirected`, `unknownFutureValue`.| |summary|String|The overview of an attack. When applicable, the summary contains details of what occurred, impacted assets, and the type of attack.| |
v1.0 | Serviceprincipal List Owners | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceprincipal-list-owners.md | Title: "servicePrincipals: List owners" + Title: "List owners of a service principal" description: "Retrieve a list of owners of the servicePrincipal." ms.localizationpriority: high doc_type: apiPageType-# servicePrincipals: List owners +# List owners of a service principal Namespace: microsoft.graph 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 service principal 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 /servicePrincipals/{id}/owners GET /servicePrincipals(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 | The following example shows a request. "name": "serviceprincipal_get_owners" }--> ```msgraph-interactive-GET https://graph.microsoft.com/v1.0/servicePrincipals/00063ffc-54e9-405d-b8f3-56124728e051/owners +GET https://graph.microsoft.com/v1.0/serviceprincipals(appId='bbec3106-565f-4907-941e-96b4dbfef21c')/owners ``` # [C#](#tab/csharp) HTTP/1.1 200 OK Content-type: application/json {- "value": [ - { - "id": "id-value" - } - ] + "@odata.context": "https://graph.microsoft.com/v1.0/$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 servicePrincipals(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 | Serviceprincipal Post Approleassignedto | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/serviceprincipal-post-approleassignedto.md | To grant an app role assignment, you need three identifiers: 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": "serviceprincipal_post_approleassignedto" } --> [!INCLUDE [permissions-table](../includes/permissions/serviceprincipal-post-approleassignedto-permissions.md)] [!INCLUDE [rbac-approleassignments-apis-write](../includes/rbac-for-apis/rbac-approleassignments-apis-write.md)] |
v1.0 | Signin Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/signin-get.md | This method supports OData query parameters to help customize the response. For | Name |Description| |:-|:-|-| Authorization | Bearer {code}| +| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| ## Request body |
v1.0 | Synchronization Serviceprincipal Put Synchronization | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-serviceprincipal-put-synchronization.md | PUT /servicePrincipals/{id}/synchronization/secrets ## 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, provide a JSON object with the following parameters. |
v1.0 | Synchronization Synchronizationjob Validatecredentials | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationjob-validatecredentials.md | POST /servicePrincipals/{id}/synchronization/jobs/{id}/validateCredentials ## 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, provide a JSON object with the following parameters. |
v1.0 | Synchronization Synchronizationschema Parseexpression | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/synchronization-synchronizationschema-parseexpression.md | POST /servicePrincipals/{id}/synchronization/templates/{id}/schema/parseExpressi ## 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, provide a JSON object with the following parameters. |
v1.0 | Teamsapp Publish | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/teamsapp-publish.md | Each app in the app catalog must have a unique manifest ID. If successful, this method returns a `200 OK` response code and a [teamsApp](../resources/teamsapp.md) object. If the app manifest has any validation errors, the request returns an error response with details about the schema errors. +### Error response ++If you send a request to upload an app manifest that contains missing information or errors, you receive an error message that includes the inner error code `UnableToParseTeamsAppManifest`. The **details** property of the inner error contains the error code and the error message. The following table describes the error codes that you might encounter. ++<br> +<details><summary>Error response</summary> ++| Error code | Error message | Description | +| :- | - | - | +|`Serialization_FileNotValidJson`| The file couldn't be parsed as a JSON object.| The submitted file didn't comply with a valid JSON format. | +|`Serialization_FileMissing`| The file {0} couldn't be found in the app package.| The expected file is missing in the app package.| +|`Serialization_TrailingCommaInManifestJsonFile`| Manifest json file contains trailing comma.| The app manifest file contains a trailing comma.| +|`SchemaError_MultipleOf`| Integer {0} isn't a multiple of {1}.| The app manifest file failed the `multipleOf` validation of the schema. Here, {0} represents the integer value and {1} indicates the required multiple. | +|`SchemaError_Maximum`| Integer {0} exceeds maximum value of {1}.| The app manifest file failed the `maximum` validation of the schema. Here, {0} represents the value that exceeds the maximum limit and {1} represents the maximum limit. | +|`SchemaError_Minimum`| Integer {0} is less than minimum value of {1}.|The app manifest file failed the `minimum` validation of the schema. Here, {0} represents the value that exceeds the minimum limit and {1} represents the minimum limit.| +|`SchemaError_MaximumLength`| String {0} exceeds maximum length of {1}.| The app manifest file failed the `maximumLength` validation of the schema. Here, {0} represents the string that exceeds the maximum length and {1} represents the maximum length.| +|`SchemaError_MinimumLength`| String {0} is less than minimum length of {1}. | The app manifest file failed the `minimumLength` validation of the schema. Here, {0} represents the string that is less than the minimum length and {1} represents the minimum.| +|`SchemaError_Pattern`| String {0} doesn't match regex pattern "{1}". | The app manifest file failed the `pattern` validation of the schema. Here, {0} represents the value that doesn't match the pattern and {1} represents the expected pattern.| +|`SchemaError_ContentEncoding`| String {0} doesn't validate against content encoding {1}.| The app manifest file failed the `contentEncoding` validation of the schema. Here, {0} represents the string that doesn't match content encoding and {1} represents the expected content encoding.| +|`SchemaError_Format`| String {0} doesn't validate against format {1}.| The app manifest file failed the `format` validation of the schema. Here, {0} represents the string that isn't in the expected format and {1} represents the expected format.| +|`SchemaError_Type`| Value {0} isn't of the expected type {1}.| The app manifest file failed the `type` validation of the schema. Here, {0} represents the string that isn't in the expected type and {1} represents the expected type.| +|`SchemaError_AdditionalItems`| The schema doesn't allow additional items.| The app manifest file failed the `additionalItems` validation of the schema.| +|`SchemaError_MaximumItems`| Array item count {0} exceeds maximum count of {1}.| The app manifest file failed the `maximumItems` validation of the schema. Here, {0} represents the number of elements in the array and {1} represents the maximum allowed.| +|`SchemaError_MinimumItems`| Array item count {0} is less than minimum count of {1}.| The app manifest file failed the `minimumItems` validation of the schema. Here, {0} represents the number of elements in the array and {1} represents the minimum allowed.| +|`SchemaError_UniqueItems`| Array contains items that aren't unique.| The app manifest file failed the `uniqueItems` validation of the schema.| +|`SchemaError_MaximumProperties`| Object property count {0} exceeds maximum count of {1}.| The app manifest file failed the `maximumProperties` validation of the schema. Here, {0} represents the number of properties provided and {1} represents the maximum allowed properties.| +|`SchemaError_MinimumProperties`| Object property count {0} is less than minimum count of {1}.|The app manifest file failed the `minimumProperties` validation of the schema. Here, {0} represents the number of properties provided and {1} represents the minimum allowed properties.| +|`SchemaError_Required`| Required properties are missing from object: {0}.| The app manifest file failed the `required` validation of the schema. Here, {0} represents the required properties. | +|`SchemaError_AdditionalProperties`| Property {0} hasn't been defined and the schema doesn't allow additional properties.| The app manifest file failed the `additionalProperties` validation of the schema. Here, {0} represents the additional property.| +|`SchemaError_Dependencies`|Dependencies for property {0} failed. Missing required keys.| The app manifest file failed the `dependencies` validation of the schema. Here, {0} represents the property that failed.| +|`SchemaError_Enum`| Value {0} isn't defined in the enum.| The app manifest file failed the `enum` validation of the schema. Here, {0} represents the value that isn't in the enum.| +|`SchemaError_AllOf`| JSON doesn't match all schemas from "allOf".| The app manifest file failed the `allOf` validation of the schema.| +|`SchemaError_AnyOf`| JSON doesn't match any schemas from "anyOf".| The app manifest file failed the `anyOf` validation of the schema.| +|`SchemaError_OneOf`| JSON is valid against more than one schema from "oneOf".| The app manifest file failed the `oneOf` validation of the schema.| +|`SchemaError_Not`| JSON is valid against schema from "not".| The app manifest file failed the `not` validation of the schema.| +|`SchemaError_Id`| Duplicate schema ID {0} encountered.| The app manifest file failed the `id` validation of the schema. Here, {0} represents the `id` of the schema.| +|`SchemaError_PatternProperties`| Couldn't test property names with regex pattern "{0}".| The app manifest file failed the `patternProperties` validation of the schema. Here, {0} represents the pattern for the properties.| +|`SchemaError_Valid`| Schema always fails validation.| The app manifest file failed the `valid` validation of the schema.| +|`SchemaError_Const`| Value {0} doesn't match constant {1}.| The app manifest file failed the `const` validation of the schema. Here, {0} represents the value that failed and {1} represents the correct value.| +|`SchemaError_Contains`| Array doesn't contain a required item.| The app manifest file failed the `contains` validation of the schema.| +|`SchemaError_Then`|JSON doesn't match schema from "then".| The app manifest file failed the `then` validation of the schema.| +|`SchemaError_Else`| JSON doesn't match schema from "else".|The app manifest file failed the `else` validation of the schema.| +| `SchemaError_Other`| The value doesn't conform to the schema for this property.| The app manifest file failed other unhandled validations of the schema.| +|`ActivityGroupIdFromActivitiesTypeValidation` | ActivityGroupId field in ActivityType must be a subset of ID field in ActivityGroup.| The `ActivityGroupId` field in `ActivityType` isn't a subset of the `Id` field in `ActivityGroup` in the app manifest.| +|`ActivityTypesMustExistWithActivitiesGroupValidation` | Manifest shouldn't contain Activity Group when Activity Types is missing.| The `ActivityGroup` property is available, but the `ActivityType` property is missing in the app manifest.| +|`ApiSecretServiceAuthTypeComposeExtensionContainsMsftEntraConfiguration`|API-based compose extension with apiSecretServiceAuth authType have microsoftEntraConfiguration defined.| The API-based compose extension has `microsoftEntraConfiguration` defined in the app manifest.| +|`ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretRegistrationId`| API-based compose extension with apiSecretServiceAuth authType have no apiSecretRegistrationId defined.| The API-based compose extension with `apiSecretServiceAuth` authType without `apiSecretRegistrationId` defined in the app manifest.| +|`ApiSecretServiceAuthTypeComposeExtensionContainsNoApiSecretServiceAuthConfiguration` | API-based compose extension with apiSecretServiceAuth authType have no apiSecretServiceConfiguration.| The API-based compose extension doesn't set `supportsSingleSignOn` to `true` in the app manifest.| +|`ApiBasedComposeExtensionManifestCommandIdsNotIncludedInOperationIdsOnApiSpecficationFile`| Command Ids on manifest aren't included in Operation Ids on API specification file.| The error that occurs when the `Command Ids` in the app manifest aren't included in `Operation Ids` on API specification file.| +|`ApiBasedComposeExtensionWithBotId`| API-based compose extension can't have botId defined.| The API-based compose extension has `botId` defined in the app manifest.| +|`ApiBasedComposeExtensionWithCanUpdateConfiguration`|API-based compose extension can't have canUpdateConfiguration defined on manifest.| The API-based compose extension has `canUpdateConfiguration` defined in the app manifest.| +|`ApiBasedComposeExtensionWithNoParameter`| API-based compose extension must have command parameters defined on manifest.| The API-based compose extension doesn't have any command parameters defined in the app manifest.| +|`ApiBasedComposeExtensionApiResponseRenderingTemplateFileNullOrEmpty`| API-based compose extension must have apiResponseRenderingTemplateFile defined on manifest.| The API-based compose extension doesn't have the `apiResponseRenderingTemplateFile` defined in the app manifest.| +|`ApiBasedComposeExtensionApiSpecificationFileNullOrEmpty`| API-based compose extension must have apiSpecificationFile defined on manifest. | The API-based compose extension doesn't have the `apiSpecificationFile` defined in the app manifest.| +|`MsftEntraAuthTypeComposeExtensionContainsApiSecretServiceConfiguration`|API-based compose extension with microsoftEntra authType have apiSecretServiceConfiguration defined. |The API-based compose extension has `apiSecretServiceConfiguration` defined in the manifest.| +|`MsftEntraAuthTypeComposeExtensionContainsNoMsftEntraConfiguration`|API-based compose extension with microsoftEntra authType have no microsoftEntraConfiguration defined.| The API-based compose extension doesn't have `microsoftEntraConfiguration` defined in the app manifest.| +|`MsftEntraAuthTypeComposeExtensionWebApplicationInfoOrResourceNotDefined`|API-based compose extension with microsoftEntra authType have no webApplicationInfo or resource defined on manifest.| The API-based compose extension with `microsoftEntra` authType doesn't have `webApplicationInfo` or `resource` defined in the app manifest.| +|`MsftEntraAuthTypeComposeExtensionResourceURLNotMatchServerURLOnApiSpec` |API-based compose extension with microsoftEntra authType resource URL on manifest doesn't match server URL on API specification file.| The API-based compose extension with `microsoftEntra` authType resource URL in the app manifest doesn't match server URL in the API specification file.| +|`NoAuthTypeComposeExtensionContainsAuthConfiguration` |API-based compose extension with none authType have auth-related configuration defined.| The API-based compose extension with authType `microsoftEntraConfiguration` or `apiSecretServiceConfiguration` isn't defined in the app manifest.| +|`ApiSpecificationFileContainUnsupportedHttpMethod`| API-based compose extension have server urls that have unsupported http method defined on apiSpecificationFile. Currently only GET and POST are supported.| The API-based compose extension has an unsupported `http` method defined in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequiredParameterContainUnsupportedLocation`| API-based compose extension have unsupported parameter location defined on apiSpecificationFile for {0}. Currently only path and query supported.| The API-based compose extension has an unsupported parameter location defined in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequestBodyContainUnsupportedMediaType`|API-based compose extension have unsupported media type defined in request body on apiSpecificationFile. Currently only application/json is supported.| The API-based compose extension has an unsupported `media` type defined in request body in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequestBodyContainUnsupportedSchemaType`| API-based compose extension have unsupported schema type defined in request body on apiSpecificationFile. Currently arrays aren't supported.| The API-based compose extension has an unsupported schema type defined in request body in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequestBodySchemaContainKeywords` | API-based compose extension have keywords.|The API-based compose extension has keywords defined in request body in the `apiSpecificationFile`.| +|`ApiSpecificationFileRequiredParameterOrPropertyNotDefinedOnManifest`| API-based compose extension have required parameters or properties {0} not defined on manifest.| The API-based compose extension has a `required` parameter, which isn't defined in the app manifest.| +|`ApiSpecificationFileResponseContainUnsupportedMediaType`| API-based compose extension have unsupported media type defined in response on apiSpecificationFile. Currently only application/json supported. | The API-based compose extension has an unsupported `media` type defined in response in the `apiSpecificationFile`.| +|`ApiSpecificationFileServerUrlsContainHttp`| API-based compose extension have server urls that have http protocol defined on apiSpecificationFile.| The API-based compose extension has server urls that contain `http` protocol in the `apiSpecificationFile`.| +|`ApiSpecificationFileServerUrlsContainInvalidUrl`| API-based compose extension have server urls that are invalid URL defined on apiSpecificationFile.| The API-based compose extension has an `invalid` URL defined in the `apiSpecificationFile`.| +|`ServerUrlsMissingOnApiSpecificationFile`| API-based compose extension have no server urls defined on apiSpecificationFile.| The error that occurs The API-based compose extension has no server urls defined in the `apiSpecificationFile`.| +|`BotBasedComposeExtensionApiResponseRenderingTemplateFileExists` |Bot based compose extension can't have apiResponseRenderingTemplateFile defined.|The bot-based compose extension has an `apiResponseRenderingTemplateFile` property defined in the app manifest.| +|`BotBasedComposeExtensionApiSpecificationFileExists` |Bot based compose extension can't have apiSpecificationFile defined.|The bot-based compose extension has an API specification file defined in the app manifest.| +|`BotBasedComposeExtensionBotIdNotGuid` |Bot based compose extension must have GUID botId.| The bot-based compose extension `botId` isn't GUID.| +|`CommonAppIdIsNotGuid`| Field 'ID' isn't a Guid in the manifest.| The `appId` isn't GUID.| +|`CommonAppIdIsRequiredField`| Required field 'ID' is missing in the manifest.| The `appId` isn't provided.| +|`CommonManifestVersionIsRequiredField`|The required field in manifest 'manifest Version' is missing.| The manifest version isn't provided.| +|`CommonSchemaUrlIsRequiredField`| Schema URL must be present.| The schema isn't provided.| +|`DashboardCardBothIconNameAndUrlPresent`| Dashboard cards icon shouldn't contain both icon name and URL.| Dashboard cards icon mustn't contain both icon name and URL.| +|`DashboardCardEntityIdsAreNotUnique`| Dashboard card entity IDs should be unique.| The returned entity Id for a dashboard card isn't unique within the manifest.| +|`DeveloperNameIsRequiredField`| Required field 'developer name' is missing in the manifest.| The developer name isn't provided.| +|`DeveloperNameLengthCheck`| Maximum character length must not exceed 32 chars.| The developer name is more than 32 characters long.| +|`DeveloperPrivacyUrlIsRequiredField`| Required field 'privacyUrl' is missing in the manifest.| The `privacyUrl` is missing in the app manifest. | +|`DeveloperPrivacyUrlMustBeHttps`| Privacy URL must be secured Support URL (HTTPS).| The developer privacy URL didn't use HTTPS.| +|`DeveloperTermsOfUseUrlIsRequiredField`| Required field 'termsOfUseUrl' is missing in the manifest.| The **termsOfUseUrl** is missing from the manifest.| +|`DeveloperTermsOfUseUrlMustBeHttps`|Terms Of Use URL must be secured Support URL (HTTPS).| The developer terms of use URL didn't use HTTPS.| +|`DeveloperWebsiteUrlIsRequiredField`| Required field 'websiteUrl' is missing in the manifest.| The developer website URL is missing.| +|`DeveloperWebsiteUrlMustBeHttps`| Website URL must be secured Support URL (HTTPS).| The developer website URL didn't use HTTPS.| +|`UniqueActivityTypeInActivitiesValidation` |Manifest shouldn't contain duplicate Activity Type.| The activity type isn't unique in the app manifest.| +|`UniqueIdInActivitiesGroupValidation` |Manifest shouldn't contain duplicate ID in Activity Groups.| The activity group ID isn't unique in the app manifest.| +|`FullDescriptionCannotBeEmpty` |Full Description can't be empty.| The full description is empty.| +|`FullDescriptionLengthCheck`| Maximum character length for long description must not exceed 4,000 chars.| The full description length is more than 4,000 characters.| +|`GroupChatForBotsLessThanV13`| Please upgrade the version of manifest to V1.3 as group chat bot is supported in manifest v1.3 onwards.| The `groupChat` scope for bots isn't supported in the app manifest version 1.3 and below.| +|`GroupChatForConfigurableTabsLessThanV13`| Please upgrade the version of manifest to V1.3 as group chat configurable tabs is supported in manifest v1.3 onwards.|The `groupChat` scope for configurable tabs isn't supported in the app manifest version 1.3 and below.| +|`InvalidColor32x32IconHeightAndWidth`|Color 32x32 icon should be 32x32 with only white and transparent.| The color 32x32 icon doesn't have the correct dimensions.| +|`InvalidColorIconHeightAndWidth`| Color Icon isn't as per the required dimension.| The dimensions of the color icon are incorrect.| +|`InvalidOutlineIconHeightAndWidth` | Small icon should be 32x32 with only white and transparent.| The dimensions of the outline icon are incorrect.| +|`ParameterOnManifestNotDefinedOnApiSpecFile` | API-based compose extension have parameters {0} on manifest not defined on API specification file.| The API-based compose extension parameters in the app manifest aren't defined in the API specification file. | +|`ReservedActivitiesValidation`| Manifest shouldn't contain reserved Activity Type 'systemDefault'.| The `systemDefault` activity type is defined in the app manifest.| +|`ReservedStaticTabNameShouldBeNull`| Reserved tab "Name" property shouldn't be specified.| The reserved `staticTabs` name property was specified.| +|`ShortDescriptionCannotBeEmpty`| Short Description canΓÇÖt be empty| The short description was empty.| +|`ShortDescriptionLengthCheck`|Maximum character length for short description must not exceed 80 chars.| The short description is more than 80 characters long.| +|`ShortNameEqualsReservedName`|Short name of the app can't be reserved name.| The short name is a reserved name.| +|`ShortNameIsRequiredField`| Short name of the app can't be empty.| The short name is empty.| +|`StaticTabNameCouldNotBeEmpty`| Non-reserved staticTabs "Name" property can't be empty.| The `staticTabs` name property is empty.| +|`BotIdIsNotGuid`| BotId isn't a Guid value.|The `BotId` value in the app manifest isn't a GUID.| +|`VersionCannotBeEmpty`| Required field "version" is missing in the manifest.| The app package version is missing.| +|`VersionContainsOnlyNumbersDotSeparated`| App version supports only numbers in the '#.#.#' format.| The version in the app package isn't matched by the pattern, `#.#.#`.| +|`VersionHasMajorLessThan1`|App version shouldn't start with '0'. Ex: 0.0.1 or 0.1 aren't valid app versions and 1.0 / 1.5.1 / 1.0.0 / 2.5.0 are valid app versions. In case of new update in manifest to an existing app in store. | The app version is less than 1.0. You need to upgrade your app version. For example, if the current version of your app in the store is 1.0 and youΓÇÖre submitting an update for validation, the app version must be higher than 1.0.| +|`ShortNameLengthCheck` |Maximum character length for Short Name must not exceed 30 chars.|The short name exceeds 30 characters.| +|`ApiSpecificationFileParameterContainUnsupportedSchemaType` |API-based compose extension have unsupported parameter schema type defined on apiSpecificationFile.Arrays aren't supported.|The API-based compose extension has an unsupported parameter schema type defined in the `apiSpecificationFile`.| ++</details> + ## Examples ### Example 1: Publish an app to the app catalog Content-type: application/json } ``` ++ ## Related content - [App catalog C# sample](https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/graph-appcatalog-lifecycle/csharp) |
v1.0 | User Changepassword | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-changepassword.md | doc_type: apiPageType Namespace: microsoft.graph -Enable the user to update their password. Any user can update their password without belonging to any administrator role. +Update the signed-in [user's](../resources/user.md) password. Any user can update their password without belonging to any administrator role. [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | User Delete Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delete-approleassignments.md | -Delete an [appRoleAssignment](../resources/approleassignment.md) that has been granted to a user. +Delete an [appRoleAssignment](../resources/approleassignment.md) that has been granted to a [user](../resources/user.md). [!INCLUDE [national-cloud-support](../../includes/all-clouds.md)] |
v1.0 | User Delta | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-delta.md | doc_type: apiPageType Namespace: microsoft.graph -Get newly created, updated, or deleted users without having to perform a full read of the entire user collection. See [change tracking](/graph/delta-query-overview) for details. +Get newly created, updated, or deleted users without having to perform a full read of the entire [user](../resources/user.md) collection. See [change tracking](/graph/delta-query-overview) for details. > [!NOTE] > Changes to the **licenseAssignmentStates** property are currently not tracked. You only need to specify any desired query parameters once upfront. In subsequent requests, copy and apply the `@odata.nextLink` or `@odata.deltaLink` URL from the previous response, as that URL already includes the encoded, desired parameters. -| Query parameter | Type |Description| +| 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 for the same user collection, 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 there are further changes to be tracked in the same user collection. | |
v1.0 | User Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-get.md | doc_type: apiPageType Namespace: microsoft.graph -Retrieve the properties and relationships of user object. +Retrieve the properties and relationships of [user](../resources/user.md) object. This operation returns by default only a subset of the more commonly used properties for each user. These _default_ properties are noted in the [Properties](../resources/user.md#properties) section. To get properties that are _not_ returned by default, do a [GET operation](user-get.md) for the user and specify the properties in a `$select` OData query option. Because the **user** resource supports [extensions](/graph/extensibility-overview), you can also use the `GET` operation to get custom properties and extension data in a **user** instance. |
v1.0 | User List Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-approleassignments.md | -Retrieve the list of [appRoleAssignments](../resources/approleassignment.md) that are currently granted to a user. This operation also returns app role assignments granted to groups that the user is a direct member of. +Retrieve the list of [appRoleAssignments](../resources/approleassignment.md) that are currently granted to a [user](../resources/user.md). This operation also returns app role assignments granted to groups that the user is a direct member of. > [!IMPORTANT] > To ensure complete results for users with many indirect app role assignments, use the **ConsistencyLevel** header set to `eventual` and `$count`, as described in [Advanced query capabilities on Azure AD directory objects](/graph/aad-advanced-queries#group-properties). For an example, see [Example 1](#example-1-list-approleassignments-granted-to-a-user). |
v1.0 | User List Memberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-memberof.md | Choose the permission or permissions marked as least privileged for this API. Us ### Permissions for the signed-in user's direct memberships -<!-- { "blockType": "permissions", "name": "user_list_memberof_1" } --> +<!-- { "blockType": "permissions", "name": "user_list_memberof" } --> ### Permissions for another user's direct memberships |
v1.0 | User List Transitivememberof | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-list-transitivememberof.md | Choose the permission or permissions marked as least privileged for this API. Us ### Permissions for the signed-in user's memberships -<!-- { "blockType": "permissions", "name": "user_list_transitivememberof_1" } --> +<!-- { "blockType": "permissions", "name": "user_list_transitivememberof" } --> ### Permissions for another user's memberships |
v1.0 | User Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/user-post-approleassignments.md | -Use this API to assign an app role to a user. To grant an app role assignment to a user, you need three identifiers: +Assign an [app role](../resources/approle.md) to a [user](../resources/user.md), creating an [appRoleAssignment](../resources/approleassignment.md) object. To grant an app role assignment to a user, you need three identifiers: - `principalId`: The `id` of the user to whom you are assigning the app role. - `resourceId`: The `id` of the resource `servicePrincipal` that has defined the app role. |
v1.0 | Userinsightssettings Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userinsightssettings-get.md | If successful, this method returns a `200 OK` response code and a [userInsightsS The following example shows a request to get user item insights and meeting hours insights settings. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "get_userInsightsSettings" The following example shows a request to get user item insights and meeting hour GET https://graph.microsoft.com/v1.0/me/settings/itemInsights ``` +# [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 | Userinsightssettings Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/userinsightssettings-update.md | If successful, this method returns a `200 OK` response code and a [userInsightsS The following example shows how a user updates the **isEnabled** privacy setting to disable their item insights and meeting hours insights. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "update_userInsightsSettings" 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 | Virtualeventsroot List Webinars | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventsroot-list-webinars.md | If successful, this method returns a `200 OK` response code and a collection of The following example shows a request. +# [HTTP](#tab/http) <!-- { "blockType": "request", "name": "list_virtualeventwebinars" The following example shows a request. GET https://graph.microsoft.com/v1.0/solutions/virtualEvents/webinars ``` +# [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 | Virtualeventsroot Post Townhalls | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventsroot-post-townhalls.md | You can specify the following properties when you create a [virtualEventTownhall | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the town hall ends. | | invitedAttendees | [identity](../resources/identity.md) collection | The identities of the attendees invited to the town hall. The supported identities are: [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). | | isInviteOnly | Boolean | Indicates whether the town hall is only open to invited people and groups within your organization. The **isInviteOnly** property can only be `true` if the value of the **audience** property is set to `organization`. |+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The virtual event settings. | | startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the town hall starts. | ## Response Content-Type: application/json "id":ΓÇ»"7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", "tenantId":ΓÇ»"77229959-e479-4a73-b6e0-ddac27be315c" }- ] + ], + "settings": { + "isAttendeeEmailNotificationEnabled": false + } } ``` Content-Type: application/json "tenantId":ΓÇ»"77229959-e479-4a73-b6e0-ddac27be315c" } ],+ "settings": { + "isAttendeeEmailNotificationEnabled": false + }, "invitedAttendees": [], "isInviteOnly": false } |
v1.0 | Virtualeventsroot Post Webinars | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventsroot-post-webinars.md | You can specify the following properties when you create a [virtualEventWebinar] | description | [itemBody](../resources/itembody.md) | A description of the webinar. | | displayName | String | The display name of the webinar. | | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the webinar ends. |+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The webinar settings. Inherited from [virtualEvent](../resources/virtualevent.md). | | startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | The date and time when the webinar starts. | ## Response Content-Type: application/json "id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b", "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" }- ] + ], + "settings": { + "isAttendeeEmailNotificationEnabled": false + } } ``` Content-Type: application/json "displayName": "Kenneth Brown", "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" }- ] + ], + "settings": { + "isAttendeeEmailNotificationEnabled": false + } } ``` |
v1.0 | Virtualeventtownhall Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventtownhall-get.md | Content-Type: application/json "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" } ],+ "settings": { + "isAttendeeEmailNotificationEnabled": false + }, "invitedAttendees": [ { "@odata.type": "microsoft.graph.communicationsUserIdentity", |
v1.0 | Virtualeventtownhall Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventtownhall-update.md | PATCH /solutions/virtualEvents/townhalls/{id} | displayName | String | Display name of the virtual event. | | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event ends. | | invitedAttendees | [identity](../resources/identity.md) collection | The identities of the attendees invited to the town hall. The supported identities are: [communicationsGuestIdentity](../resources/communicationsguestidentity.md) and [communicationsUserIdentity](../resources/communicationsuseridentity.md). |+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The virtual event settings. | | startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event starts. | ## Response Content-Type: application/json "displayName": "Emilee Pham", "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" }- ] + ], + "settings": { + "isAttendeeEmailNotificationEnabled": false + } } ``` |
v1.0 | Virtualeventwebinar Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/virtualeventwebinar-update.md | PATCH /solutions/virtualEvents/webinars/{id} | description | [itemBody](../resources/itembody.md) | Description of the virtual event. | | displayName | String | Display name of the virtual event. | | endDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event ends. |+| settings | [virtualEventSettings](../resources/virtualeventsettings.md) | The webinar settings. Inherited from [virtualEvent](../resources/virtualevent.md). | | startDateTime | [dateTimeTimeZone](../resources/datetimetimezone.md) | Date and time when the virtual event starts. | ## Response Content-Type: application/json "displayName": "Kenneth Brown", "tenantId": "77229959-e479-4a73-b6e0-ddac27be315c" }- ] + ], + "settings": { + "isAttendeeEmailNotificationEnabled": false + } } ``` |
v1.0 | Webpart Delete | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/webpart-delete.md | DELETE /sites/{site-id}/pages/{page-id}/microsoft.graph.sitePage/canvasLayout/ho ``` ## Request headers -| Name | Value | Description -|:--|:|:-- -|Authorization|Bearer {token}.| Required| -| _if-match_ | etag | If this request header is included and the eTag provided does not match the current tag on the item, a `412 Precondition Failed` response is returned and the item will not be deleted. +|Name|Description| +|:|:| +|Authorization| Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).| +| _if-match_ | eTag. If this request header is included and the eTag provided does not match the current tag on the item, a `412 Precondition Failed` response is returned and the item will not be deleted.| ## Request body |
v1.0 | Workbookformatprotection Get | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/workbookformatprotection-get.md | Retrieve the properties and relationships of formatprotection 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": "formatprotection_get" } --> +<!-- { "blockType": "permissions", "name": "workbookformatprotection_get" } --> ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Workbookformatprotection Update | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/api/workbookformatprotection-update.md | Update the properties of formatprotection 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": "formatprotection_update" } --> +<!-- { "blockType": "permissions", "name": "workbookformatprotection_update" } --> ## HTTP request <!-- { "blockType": "ignored" } --> |
v1.0 | Accesspackageassignmentrequest | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accesspackageassignmentrequest.md | In [Microsoft Entra Entitlement Management](entitlementmanagement-overview.md), | [Create](../api/entitlementmanagement-post-assignmentrequests.md) | [accessPackageAssignmentRequest](accesspackageassignmentrequest.md) | Creates a new **accessPackageAssignmentRequest** object. | |[Get](../api/accesspackageassignmentrequest-get.md)|[accessPackageAssignmentRequest](accesspackageassignmentrequest.md)|Read properties and relationships of an **accessPackageAssignmentRequest** object. | |[Delete](../api/accesspackageassignmentrequest-delete.md)|None|Delete an **accessPackageAssignmentRequest**. |-|[Filter by current user](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.| |[Cancel](../api/accesspackageassignmentrequest-cancel.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Cancel an **accessPackageAssignmentRequest** object that is in a cancelable state.|+|[Filter by current user](../api/accesspackageassignmentrequest-filterbycurrentuser.md)|[accessPackageAssignmentRequest](../resources/accesspackageassignmentrequest.md) collection|Retrieve the list of **accessPackageAssignmentRequest** objects filtered on the signed-in user.| |[Reprocess](../api/accesspackageassignmentrequest-reprocess.md) | None | Automatically retry a userΓÇÖs request for access to an access package.|+|[Resume](../api/accesspackageassignmentrequest-resume.md) | None | Resume a user's access package request after waiting for a callback from a custom extension.| ## Properties |Property|Type|Description| |
v1.0 | Accessreviewhistoryschedulesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewhistoryschedulesettings.md | Defines the settings of an [accessReviewHistoryDefinition](accessreviewhistoryde | recurrence|[patternedRecurrence](patternedrecurrence.md) | Detailed settings for recurrence using the standard Outlook recurrence object. <br/><br/>**Note:** Only **dayOfMonth**, **interval**, and **type** (`weekly`, `absoluteMonthly`) properties are supported. Use the property **startDate** on **recurrenceRange** to determine the day the review starts. Required. | |reportRange|String|A duration string in ISO 8601 duration format specifying the lookback period of the generated review history data. For example, if a history definition is scheduled to run on the first of every month, the **reportRange** is `P1M`. In this case, on the first of every month, access review history data is collected containing only the previous month's review data. <br/><br/>**Note:** Only **years**, **months**, and **days** ISO 8601 properties are supported. Required.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewHistoryScheduleSettings" |
v1.0 | Accessreviewstagesettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/accessreviewstagesettings.md | Represents the settings of the stages that are associated with a [multi-stage ac |reviewers|[accessReviewReviewerScope](../resources/accessreviewreviewerscope.md) collection|Defines who the reviewers are. If none is specified, the review is a self-review (users review their own access). For examples of options for assigning reviewers, see [Assign reviewers to your access review definition using the Microsoft Graph API](/graph/accessreviews-reviewers-concept). <br/><br/>**NOTE:** The value of this property overrides the corresponding setting on the [accessReviewScheduleDefinition](accessReviewScheduleDefinition.md). | |stageId|String|Unique identifier of the **accessReviewStageSettings** object. The **stageId** is used by the **dependsOn** property to indicate the order of the stages. Required. | +## Relationships ++None. + ## JSON representation-HEre's a JSON representation of the resource. ++The following JSON representation shows the resource type. + <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.accessReviewStageSettings" |
v1.0 | Admin | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/admin.md | None. | edge | [edge](edge.md) | A container for Microsoft Edge resources. Read-only. | | microsoft365Apps |[adminMicrosoft365Apps](../resources/adminmicrosoft365apps.md)|A container for the Microsoft 365 apps admin functionality.| | people | [peopleAdminSettings](../resources/peopleadminsettings.md) | Represents a setting to control people-related admin settings in the tenant. |+| reportSettings |[adminReportSettings](../resources/adminreportsettings.md)|A container for administrative resources to manage reports.| | serviceAnnouncement | [serviceAnnouncement](serviceannouncement.md) | A container for service communications resources. Read-only. | | sharepointSettings | [sharepointSettings](../resources/sharepointSettings.md) | A container for administrative resources to manage tenant-level settings for SharePoint and OneDrive. | |
v1.0 | Adminreportsettings | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/adminreportsettings.md | + + Title: "adminReportSettings resource type" +description: "Represents the tenant-level settings for Microsoft 365 reports." +ms.localizationpriority: medium +++++# adminReportSettings resource type ++Namespace: microsoft.graph ++Represents the tenant-level settings for Microsoft 365 reports. ++## Methods ++|Method|Return type|Description| +|:|:|:| +|[Get](../api/adminreportsettings-get.md)|[adminReportSettings](../resources/adminreportsettings.md)|Get the tenant-level settings for Microsoft 365 reports.| +|[Update](../api/adminreportsettings-update.md)|[adminReportSettings](../resources/adminreportsettings.md)|Update tenant-level settings for Microsoft 365 reports.| ++## Properties ++| Property | Type | Description | +| -- | -- | - | +| 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. | ++## JSON representation ++The following JSON representation shows the resource type. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.adminReportSettings", + "baseType": "microsoft.graph.entity", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.adminReportSettings", + "displayConcealedNames": "Boolean" +} +``` |
v1.0 | Aggregationoption | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/aggregationoption.md | Specifies which aggregations should be returned alongside the search results. Th |field|String|Computes aggregation on the field while the field exists in the current entity type. Required.| |size|Int32|The number of [searchBucket](searchBucket.md) resources to be returned. This isn't required when the range is provided manually in the search request. The minimum accepted size is 1, and the maximum is 65535. Optional.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Agreementfiledata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/agreementfiledata.md | Represents a Microsoft Entra terms of use agreement file. |:-|:|:| |data|Binary|Data that represents the terms of use PDF document. Read-only.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Alterationresponse | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/alterationresponse.md | Provides information related to spelling corrections in the alteration response. |queryAlteration|[searchAlteration](searchalteration.md)| Defines the details of the alteration information for the spelling correction.| |queryAlterationType|searchAlterationType| Defines the type of the spelling correction. Possible values are: `suggestion`, `modification`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Alteredquerytoken | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/alteredquerytoken.md | Represents changed segments related to an original user query. |offset|Int32| Defines the offset of a changed segment.| |suggestion|String| Represents the corrected segment string.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Appidentity | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/appidentity.md | Title: "appIdentity resource type" -description: "Indicates the identity of the application that performed the action or was changed. Includes Application Id, Name, Service Principal ID and Name. This resource is called by the directoryAudit API" +description: "Indicates the identity of the application that performed the action or was changed. This resource is called by the directoryAudit API" ms.localizationpriority: medium doc_type: resourcePageType Namespace: microsoft.graph -Indicates the identity of the application that performed the action or was changed. Includes application ID, name, and service principal ID and name. This resource is used by the [Get directoryAudit](../api/directoryaudit-get.md) operation. +Indicates the identity of the application that performed the action or was changed. Includes the application ID, name, and service principal ID and name. This resource is used by the [directoryAudit](../api/directoryaudit-get.md) operation. ## Properties Indicates the identity of the application that performed the action or was chang |servicePrincipalId|String|Refers to the unique ID for the service principal in Microsoft Entra ID.| |servicePrincipalName|String|Refers to the Service Principal Name is the Application name in the tenant. | +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Approleassignment | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/approleassignment.md | Title: "appRoleAssignment resource type" -description: "Used to record when a user, group, or service principal is assigned to an app role on an application's service principal. You can create, read and delete app role assignments." +description: "Used to record when a user, group, or service principal is assigned to an app role on an application's service principal. You can create, read, and delete app role assignments." ms.localizationpriority: high doc_type: resourcePageType Used to record when a user, group, or service principal is assigned an app role An app role assignment is a relationship between the assigned principal (a user, a group, or a service principal), a resource application (the app's service principal) and an app role defined on the resource application. -When the [app role](approle.md) which has been assigned to a principal has a non-empty **value** property, this will be included in the **roles** claim of tokens where the subject is the assigned principal (e.g. SAML responses, ID tokens, access tokens identifying a signed-in user, or an access token identifying a service principal). Applications and APIs use these claims as part of their authorization logic. +When the [app role](approle.md) that has been assigned to a principal has a nonempty **value** property, it's included in the **roles** claim of tokens where the subject is the assigned principal (for example, SAML responses, ID tokens, access tokens identifying a signed-in user, or an access token identifying a service principal). Applications and APIs use these claims as part of their authorization logic. A user can be assigned an app role directly. If an app role is assigned to a group, direct members of the group are also considered to have been assigned the app role. When a user is assigned an app role for an application, a tile for that application is displayed in the user's [MyApps portal](/azure/active-directory/user-help/my-apps-portal-end-user-access) and [Microsoft 365 app launcher](https://support.office.com/article/meet-the-office-365-app-launcher-79f12104-6fed-442f-96a0-eb089a3f476a). An app role assignment where the assigned principal is a service principal is an ## Methods |Method|Return type|Description| |:|:|:|-|[List appRoleAssignments granted to a group](../api/group-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[List appRoleAssignments granted to a user](../api/user-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[List appRoleAssignments granted to a service principal](../api/serviceprincipal-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[List appRoleAssignments granted to users, groups, and client service principals for a resource service principal](../api/serviceprincipal-list-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties.| -|[Grant an appRole to a group](../api/group-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Grant an appRole to a user](../api/user-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Grant an appRole to a service principal](../api/serviceprincipal-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Grant a user, group, or client service principal an appRoleAssignment for a resource service principal](../api/serviceprincipal-post-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object. -|[Get appRoleAssignment](../api/approleassignment-get.md)|[appRoleAssignment](../resources/approleassignment.md)|Get a new [appRoleAssignment](../resources/approleassignment.md) object.| -|[Delete an appRoleAssignment from a group](../api/group-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| -|[Delete an appRoleAssignment from a user](../api/user-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| -|[Delete an appRoleAssignment from a service principal](../api/serviceprincipal-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| -|[Delete an appRoleAssignment granted to a user, group, or client service principal for a resource service principal](../api/serviceprincipal-delete-approleassignedto.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object.| +|[List app role assignments for a group](../api/group-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a group.| +|[List app role assignments for a user](../api/user-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a user.| +|[List app role assignments for a client service principal](../api/serviceprincipal-list-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for a client service principal.| +|[List app role assignments for users, groups, and client service principals for a resource service principal](../api/serviceprincipal-list-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Get a list of the [appRoleAssignment](../resources/approleassignment.md) objects and their properties for users, groups, and client service principals for a specified resource service principal.| +|[Grant app role to a group](../api/group-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a group.| +|[Grant app role to a user](../api/user-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md)|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a user.| +|[Grant app role to a client service principal](../api/serviceprincipal-post-approleassignments.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object for a client service principal.| +|[Grant app role assignment to user, group, or client service principal for a resource service principal](../api/serviceprincipal-post-approleassignedto.md)|[appRoleAssignment](../resources/approleassignment.md) collection|Create a new [appRoleAssignment](../resources/approleassignment.md) object to a user, group, or client service principal for a specified resource service principal.| +|[Get app role assignment](../api/approleassignment-get.md)|[appRoleAssignment](../resources/approleassignment.md)|Get an [appRoleAssignment](../resources/approleassignment.md) object assigned to a user, group, or client service principal for a resource service principal.| +|[Delete app role assignment for a group](../api/group-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a group.| +|[Delete app role assignment for a user](../api/user-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a user.| +|[Delete app role assignment for a client service principal](../api/serviceprincipal-delete-approleassignments.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a client service principal.| +|[Delete app role assignment for user, group, or client service principal to a resource service principal](../api/serviceprincipal-delete-approleassignedto.md)|None|Delete an [appRoleAssignment](../resources/approleassignment.md) object from a user, group, or client service principal for a specified resource service principal.| ## Properties | Property | Type | Description | |:|:--|:-|-| appRoleId | Guid | The identifier (**id**) for the [app role](approle.md) which is assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application has not declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create. | +| appRoleId | Guid | The identifier (**id**) for the [app role](approle.md) that's assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application hasn't declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create. | | createdDateTime | DateTimeOffset | The time when the app role assignment was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. | | deletedDateTime | DateTimeOffset | The date and time when the app role assignment was deleted. Always `null` for an appRoleAssignment object that hasn't been deleted. Inherited from [directoryObject](directoryobject.md). | | id | String | A unique identifier for the **appRoleAssignment** key. Not nullable. Read-only. | |
v1.0 | Archivedprintjob | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/archivedprintjob.md | A record of a "final state" (completed, aborted, or canceled) print job that is |processingState|printJobProcessingState|The print job's final processing state. Read-only.| |createdDateTime|DateTimeOffset|The dateTimeOffset when the job was created. Read-only.| |acquiredDateTime|DateTimeOffset|The dateTimeOffset when the job was acquired by the printer, if any. Read-only.|-|completionDateTime|DateTimeOffset|The dateTimeOffset when the job was completed, canceled or aborted. Read-only.| +|completionDateTime|DateTimeOffset|The dateTimeOffset when the job was completed, canceled, or aborted. Read-only.| |acquiredByPrinter|Boolean|True if the job was acquired by a printer; false otherwise. Read-only.| |copiesPrinted|Int32|The number of copies that were printed. Read-only.| |createdBy|[userIdentity](useridentity.md)|The user who created the print job. Read-only.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Availabilityitem | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/availabilityitem.md | Indicates the status of a [staff member](bookingstaffmember.md) for a given time |status |bookingsAvailabilityStatus |The status of the staff member. Possible values are: `available`, `busy`, `slotsAvailable`, `outOfOffice`, `unknownFutureValue`.| |startDateTime |dateTimeTimeZone |The start time of the time slot.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Bookingcustomerinformationbase | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingcustomerinformationbase.md | Abstract base type for an appointment's customer information. Base type of [bookingCustomerInformation](bookingcustomerinformation.md). +## Properties ++None. ++## Relationships ++None. + ## JSON representation+ The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.bookingCustomerInformationBase" |
v1.0 | Bookingreminder | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingreminder.md | Represents when and whom to send an email reminder. |offset|Duration|The amount of time before the start of an appointment that the reminder should be sent. It's denoted in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.| |recipients|bookingReminderRecipients|The persons who should receive the reminder. Possible values are: `allAttendees`, `staff`, `customer`, `unknownFutureValue`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Bookingschedulingpolicy | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingschedulingpolicy.md | Namespace: microsoft.graph Represents the set of policies that determine how appointments should be created in a Microsoft Bookings calendar. +> [!NOTE] +> +> If the Default Scheduling Policy is enabled at the service level, the values of this resource are limited to those defined in the policy in the [List services](/graph/api/bookingbusiness-list-services) API response. In this case, the client must fall back to the Default Scheduling Policy for the business. + ## Properties | Property | Type |Description| |:|:--|:-| Represents the set of policies that determine how appointments should be created |sendConfirmationsToOwner|Boolean| `True` to notify the business via email when a booking is created or changed. Use the email address specified in the **email** property of the **bookingBusiness** entity for the business. | |timeSlotInterval|Duration|Duration of each time slot, denoted in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Bookingworkhours | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingworkhours.md | Represents the set of working hours in a single day of the week, for a [bookingB |day|String| The day of the week represented by this instance. Possible values are: `sunday`, `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`.| |timeSlots|[bookingWorkTimeSlot](bookingworktimeslot.md) collection|A list of start/end times during a day.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Bookingworktimeslot | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bookingworktimeslot.md | Defines the start and end times for work. |endTime|TimeOfDay|The time of the day when work stops. For example, 17:00:00.0000000.| |startTime|TimeOfDay|The time of the day when work starts. For example, 08:00:00.0000000.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Bucketaggregationdefinition | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bucketaggregationdefinition.md | Provides the details on how to generate the aggregations in the results. |minimumCount|Int32|The minimum number of items that should be present in the aggregation to be returned in a bucket. Optional.| |prefixFilter|String|A filter to define a matching criteria. The key should start with the specified prefix to be returned in the response. Optional.| |ranges|[bucketAggregationRange](bucketaggregationrange.md) collection|Specifies the manual ranges to compute the aggregations. This is only valid for nonstring refiners of date or numeric type. Optional.|-|sortBy|bucketAggregationSortProperty| The possible values are `count` to sort by the number of matches in the aggregation, `keyAsString`to sort alphabetically based on the key in the aggregation, `keyAsNumber` for numerical sorting based on the key in the aggregation. Required. +|sortBy|bucketAggregationSortProperty| The possible values are `count` to sort by the number of matches in the aggregation, `keyAsString`to sort alphabetically based on the key in the aggregation, `keyAsNumber` for numerical sorting based on the key in the aggregation. Required.| ++## Relationships ++None. ## JSON representation |
v1.0 | Bucketaggregationrange | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/bucketaggregationrange.md | Specifies the lower and upper limit to a range for aggregating search results. A |from|String| Defines the lower bound from which to compute the aggregation. This can be a numeric value or a string representation of a date using the `YYYY-MM-DDTHH:mm:ss.sssZ` format. Required.| |to|String| Defines the upper bound up to which to compute the aggregation. This can be a numeric value or a string representation of a date using the `YYYY-MM-DDTHH:mm:ss.sssZ` format. Required.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Collapseproperty | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/collapseproperty.md | Specifies the criteria used for collapsing search results. Applies only to sorta |fields|String Collection| Defines the collapse group to trim results. The properties in this collection must be sortable/refinable properties. Required.| |limit|Int16| Defines a maximum limit count for this field. This numeric value must be a positive integer. Required.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Customextensionauthenticationconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionauthenticationconfiguration.md | The type of token authentication used depends on the token security. If the toke None. +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionAuthenticationConfiguration", |
v1.0 | Customextensionendpointconfiguration | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/customextensionendpointconfiguration.md | Abstract base type that exposes the derived types used to configure the **endpoi None. +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type.+ <!-- { "blockType": "resource", "@odata.type": "microsoft.graph.customExtensionEndpointConfiguration", |
v1.0 | Datetimetimezone | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/datetimetimezone.md | Pacific/Apia Pacific/Kiritimati +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Devicedetail | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/devicedetail.md | doc_type: resourcePageType Namespace: microsoft.graph -Indicates device details associated with a device used for signing in. The information includes information like device browser and operating system, and whether the device is Microsoft Entra ID managed. +Indicates details of the device used in a sign-in activity. Includes information like device browser and OS info and if the device is Microsoft Entra ID-managed. ## Properties- | Property | Type |Description| |:|:--|:-|-|browser|String|Indicates the browser information of the used for signing in.| -|deviceId|String|Refers to the UniqueID of the device used for signing in.| -|displayName|String|Refers to the name of the device used for signing in.| -|isCompliant|Boolean|Indicates whether the device is compliant.| -|isManaged|Boolean|Indicates whether the device is managed.| -|operatingSystem|String|Indicates the operating system name and version used for signing in.| -|trustType|String|Provides information about whether the signed-in device is Workplace Joined, AzureAD Joined, Domain Joined. | +|browser|String|Indicates the browser information of the used in the sign-in. Populated for devices registered in Microsoft Entra.| +|deviceId|String|Refers to the unique ID of the device used in the sign-in. Populated for devices registered in Microsoft Entra.| +|displayName|String|Refers to the name of the device used in the sign-in. Populated for devices registered in Microsoft Entra.| +|isCompliant|Boolean|Indicates whether the device is compliant or not.| +|isManaged|Boolean|Indicates if the device is managed or not.| +|operatingSystem|String|Indicates the OS name and version used in the sign-in.| +|trustType|String|Indicates information on whether the device used in the sign-in is workplace-joined, Microsoft Entra-joined, domain-joined.| ## JSON representation |
v1.0 | Educationassignmentclassrecipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentclassrecipient.md | This resource is a subclass of [educationAssignmentRecipient](educationassignmen None. +## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. + <!-- { "blockType": "resource", |
v1.0 | Educationassignmentgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentgrade.md | This is an abstract type that will never be instantiated; however, all types of |gradedBy|[identitySet](identityset.md)| User who did the grading. | |gradedDateTime|DateTimeOffset| Moment in time when the grade was applied to this submission object. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationassignmentgradetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentgradetype.md | Base class for [educationAssignmentPointsGradeType](../resources/educationassign None. +## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. + <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Educationassignmentindividualrecipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentindividualrecipient.md | This resource is a subclass of [educationAssignmentRecipient](educationassignmen |:|:--|:-| |recipients|String collection|A collection of IDs of the recipients.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationassignmentpointsgrade | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentpointsgrade.md | which will add the who data to this property. The max points are stored in the * |gradedDateTime|DateTimeOffset| Moment in time when the grade was applied to this submission object. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |points|Single|Number of points a teacher is giving this submission object.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationassignmentpointsgradetype | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentpointsgradetype.md | an [educationAssignmentPointsGrade](educationassignmentpointsgrade.md) property |:|:--|:-| |maxPoints|Single| Max points possible for this assignment. | +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationassignmentrecipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationassignmentrecipient.md | The [educationAssignmentClassRecipient](educationassignmentclassrecipient.md) an ## Properties None. +## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. + <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Educationcategory | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationcategory.md | A category that can be applied to assignments. |displayName|String|Unique identifier for the category.| |id|String|Unique identifier for the category.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationchannelresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationchannelresource.md | A subclass of [educationResource](educationresource.md) that represents a Micros | :- | :-- | : | | url | String | URL of the channel resource. | +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationexcelresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationexcelresource.md | or submission object to which this resource belongs. |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationexternalresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationexternalresource.md | This complex type allows all SDK callers to work seamlessly. |displayName|string|The display name of the resource.| |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|-|webUrl|String|Location of the resource. Required| +|webUrl|String|Location of the resource. Required.| ++## Relationships ++None. ## JSON representation The following JSON representation shows the resource type.- <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Educationfeedback | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationfeedback.md | This property represents both the text part of the feedback along with who provi |feedbackDateTime|DateTimeOffset|Moment in time when the feedback was given. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`| |text|[itemBody](itembody.md)|Feedback.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationfileresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationfileresource.md | In this case, the file isn't one of the special files (Word, Excel, and so on) b |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationlinkedassignmentresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationlinkedassignmentresource.md | A subclass of [educationResource](educationresource.md) that represents a link t | :- | :-- | :- | | url | String | URL of the actual assignment. | +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationlinkresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationlinkresource.md | This resource is a link and doesn't have any other data associated with it. |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| |link|String|URL to the resource.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationmediaresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationmediaresource.md | The following file types are media resources: `webm`, `mkv`, `avi`, `wmv`, `mp4` |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationpowerpointresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationpowerpointresource.md | assignment or submission. |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationresource.md | This resource stores the common properties across all resource types. |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|Moment in time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationsubmissionindividualrecipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationsubmissionindividualrecipient.md | A subclass of [educationSubmissionRecipient](educationsubmissionrecipient.md) th |:|:--|:-| |userId|String|User ID of the user to whom the submission is assigned.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Educationsubmissionrecipient | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationsubmissionrecipient.md | Possible values include individuals or groups. This is used within the **submiss ## Properties None. +## Relationships ++None. ++## JSON representation ++The following JSON representation shows the resource type. + <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Educationteamsappresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationteamsappresource.md | Inherits from [educationResource](educationresource.md). | teamsEmbeddedContentUrl | String | URL for the app resource that will be opened by Teams. | | webUrl | String | URL for the app resource that can be opened in the browser. | +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type.- <!-- { "blockType": "resource", "optionalProperties": [ |
v1.0 | Educationwordresource | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/educationwordresource.md | assignment or submission. |lastModifiedBy|[identitySet](identityset.md)|The last user to modify the resource.| |lastModifiedDateTime|DateTimeOffset|The date and time when the resource was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.| +## Relationships ++None. + ## JSON representation The following JSON representation shows the resource type. |
v1.0 | Employeeorgdata | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/employeeorgdata.md | description: "Represents organization data associated with a user." ms.localizationpriority: medium doc_type: resourcePageType -+ # employeeOrgData resource type |
v1.0 | Enums | https://github.com/microsoftgraph/microsoft-graph-docs-contrib/commits/main/api-reference/v1.0/resources/enums.md | Namespace: microsoft.graph |boolean| |unknownFutureValue| -## fileStorageContainerStatus values +### fileStorageContainerStatus values | Member | | -- | Namespace: microsoft.graph | active | | unknownfuturevalue | -## binaryOperator values +### binaryOperator values | Member | | - | | or | | and | -## entityType values +### entityType values | Member | | - | Namespace: microsoft.graph | acronym | | bookmark | -## conditionalAccessExternalTenantsMembershipKind values +### conditionalAccessExternalTenantsMembershipKind values | Member | | -- | Namespace: microsoft.graph | enumerated | | unknownFutureValue | -## conditionalAccessGuestOrExternalUserTypes values +### conditionalAccessGuestOrExternalUserTypes values | Member | | | Namespace: microsoft.graph | serviceProvider | | unknownFutureValue | -## migrationStatus values +### migrationStatus values | Member | | - | Namespace: microsoft.graph | additionalStepsRequired | | unknownFutureValue | -## appCredentialRestrictionType values +### appCredentialRestrictionType values | Member | | -- | Namespace: microsoft.graph | symmetricKeyLifetime | | unknownFutureValue | -## appKeyCredentialRestrictionType values +### appKeyCredentialRestrictionType values | Member | | | | asymmetricKeyLifetime | | unknownFutureValue | -## assignmentType values +### assignmentType values | Member | | -- | Namespace: microsoft.graph | unknownFutureValue | | peerRecommeded | -## courseStatus values +### courseStatus values | Member | | | Namespace: microsoft.graph | inProgress | | completed | -## userPurpose values +### userPurpose values | Member | | | Namespace: microsoft.graph | others | | unknownFutureValue | -## bookingsAvailabilityStatus values +### bookingsAvailabilityStatus values | Member | | | Namespace: microsoft.graph | outOfOffice | | unknownFutureValue | -## signInFrequencyAuthenticationType values +### signInFrequencyAuthenticationType values | Member | | | Namespace: microsoft.graph | secondaryAuthentication | | unknownFutureValue | -## signInFrequencyInterval values +### signInFrequencyInterval values | Member | | | | timeBased | | everyTime | -## crossTenantAccessPolicyTargetConfigurationAccessType values +### crossTenantAccessPolicyTargetConfigurationAccessType values | Member | | | Namespace: microsoft.graph | blocked | | unknownFutureValue | -## crossTenantAccessPolicyTargetType values +### crossTenantAccessPolicyTargetType values | Member | | | Namespace: microsoft.graph | application | | unknownFutureValue | -## multiTenantOrganizationMemberProcessingStatus values +### multiTenantOrganizationMemberProcessingStatus values | Member | | - | Namespace: microsoft.graph | failed | | unknownFutureValue | -## multiTenantOrganizationMemberRole values +### multiTenantOrganizationMemberRole values | Member | | - | Namespace: microsoft.graph | member | | unknownFutureValue | -## multiTenantOrganizationMemberState values +### multiTenantOrganizationMemberState values | Member | | - | Namespace: microsoft.graph | removed | | unknownFutureValue | -## multiTenantOrganizationState values +### multiTenantOrganizationState values | Member | | - | Namespace: microsoft.graph | inactive | | unknownFutureValue | -## templateApplicationLevel values +### templateApplicationLevel values | Member | | - | Namespace: microsoft.graph | existingPartners | | unknownFutureValue | -## federatedIdpMfaBehavior values +### federatedIdpMfaBehavior values | Member | | -- | Namespace: microsoft.graph | rejectMfaByFederatedIdp | | unknownFutureValue | -## promptLoginBehavior values +### promptLoginBehavior values | Member | | -- | Namespace: microsoft.graph | disabled | | unknownFutureValue | -## expirationPatternType values +### expirationPatternType values | Member | | - | Namespace: microsoft.graph | afterDateTime | | afterDuration | -## recurrencePatternType values +### recurrencePatternType values | Member | | | Namespace: microsoft.graph | absoluteYearly | | relativeYearly | -## assignmentScheduleFilterByCurrentUserOptions values +### assignmentScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## assignmentScheduleInstanceFilterByCurrentUserOptions values +### assignmentScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## assignmentScheduleRequestFilterByCurrentUserOptions values +### assignmentScheduleRequestFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | approver | | unknownFutureValue | -## eligibilityScheduleFilterByCurrentUserOptions values +### eligibilityScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## eligibilityScheduleInstanceFilterByCurrentUserOptions values +### eligibilityScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## eligibilityScheduleRequestFilterByCurrentUserOptions values +### eligibilityScheduleRequestFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | approver | | unknownFutureValue | -## privilegedAccessGroupAssignmentType values +### privilegedAccessGroupAssignmentType values | Member | | | Namespace: microsoft.graph | activated | | unknownFutureValue | -## privilegedAccessGroupMemberType values +### privilegedAccessGroupMemberType values | Member | | | Namespace: microsoft.graph | group | | unknownFutureValue | -## privilegedAccessGroupRelationships values +### privilegedAccessGroupRelationships values | Member | | | Namespace: microsoft.graph | member | | unknownFutureValue | -## scheduleRequestActions values +### scheduleRequestActions values | Member | | | Namespace: microsoft.graph | selfRenew | | unknownFutureValue | -## roleAssignmentScheduleFilterByCurrentUserOptions values +### roleAssignmentScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## roleAssignmentScheduleInstanceFilterByCurrentUserOptions values +### roleAssignmentScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## roleAssignmentScheduleRequestFilterByCurrentUserOptions values +### roleAssignmentScheduleRequestFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | approver | | unknownFutureValue | -## roleEligibilityScheduleFilterByCurrentUserOptions values +### roleEligibilityScheduleFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## roleEligibilityScheduleInstanceFilterByCurrentUserOptions values +### roleEligibilityScheduleInstanceFilterByCurrentUserOptions values | Member | | | | principal | | unknownFutureValue | -## roleEligibilityScheduleRequestFilterByCurrentUserOptions values +### roleEligibilityScheduleRequestFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | approver | | unknownFutureValue | -## unifiedRoleManagementPolicyRuleTargetOperations values +### unifiedRoleManagementPolicyRuleTargetOperations values | Member | | | Namespace: microsoft.graph | renew | | unknownFutureValue | -## userSignInRecommendationScope values +### userSignInRecommendationScope values | Member | | | Namespace: microsoft.graph | application | | unknownFutureValue | -## unifiedRoleScheduleRequestActions values +### unifiedRoleScheduleRequestActions values | Member | | | Namespace: microsoft.graph | selfRenew | | unknownFutureValue | -## approvalFilterByCurrentUserOptions values +### approvalFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | approver | | unknownFutureValue | -## accessReviewExpirationBehavior values +### accessReviewExpirationBehavior values | Member | | -- | Namespace: microsoft.graph | acceptAccessRecommendation | | unknownFutureValue | -## allowedTargetScope values +### allowedTargetScope values | Member | | | Namespace: microsoft.graph | allExternalUsers | | unknownFutureValue | -## accessPackageAssignmentFilterByCurrentUserOptions values +### accessPackageAssignmentFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | createdBy | | unknownFutureValue | -## accessPackageAssignmentRequestFilterByCurrentUserOptions values +### accessPackageAssignmentRequestFilterByCurrentUserOptions values | Member | | | Namespace: microsoft.graph | approver | | unknownFutureValue | -## accessPackageAssignmentState values +### accessPackageAssignmentState values | Member | | | Namespace: microsoft.graph | deliveryFailed | | unknownFutureValue | -## accessPackageCatalogState values +### accessPackageCatalogState values | Member | | | Namespace: microsoft.graph | published | | unknownFutureValue | -## accessPackageCatalogType values +### accessPackageCatalogType values | Member | | | Namespace: microsoft.graph | serviceManaged | | unknownFutureValue | -## accessPackageExternalUserLifecycleAction values +### accessPackageExternalUserLifecycleAction values | Member | | -- | Namespace: microsoft.graph | blockSignInAndDelete | | unknownFutureValue | -## accessPackageFilterByCurrentUserOptions values +### accessPackageFilterByCurrentUserOptions values | Member | | | | allowedRequestor | | unknownFutureValue | -## accessPackageRequestState values +### accessPackageRequestState values | Member | | | Namespace: microsoft.graph | partiallyDelivered | | unknownFutureValue | -## accessPackageRequestType values +### accessPackageRequestType values | Member | | | Namespace: microsoft.graph | onBehalfAdd | | unknownFutureValue | -## accessPackageSubjectType values +### accessPackageSubjectType values | Member | | | Namespace: microsoft.graph | servicePrincipal | | unknownFutureValue | -## connectedOrganizationState values +### connectedOrganizationState values | Member | | - | | configured | | proposed | -## accessReviewInstanceDecisionItemFilterByCurrentUserOptions values +### accessReviewInstanceDecisionItemFilterByCurrentUserOptions values | Member | | | | reviewer | | unknownFutureValue | -## accessReviewStageFilterByCurrentUserOptions values +### accessReviewStageFilterByCurrentUserOptions values | Member | | | | reviewer | | unknownFutureValue | -## accessPackageCustomExtensionStage values +### accessPackageCustomExtensionStage values | Member | | - | Namespace: microsoft.graph | assignmentOneDayBeforeExpiration | | unknownFutureValue | -## customExtensionCalloutInstanceStatus values +### customExtensionCalloutInstanceStatus values | Member | | - | Namespace: microsoft.graph | waitingForCallback | | unknownFutureValue | -## volumeType values +### volumeType values | Member | | | Namespace: microsoft.graph | removableDataVolume | | unknownFutureValue | -## filterMode values +### filterMode values | Member | | - | | include | | exclude | -## lifecycleEventType values +### lifecycleEventType values | Member | | -- | Namespace: microsoft.graph | subscriptionRemoved | | reauthorizationRequired | -## changeType values +### changeType values | Member | | - | | clientIpAddress | | authenticatorAppGps | -## countryLookupMethodType values +### countryLookupMethodType values | Member | | - | | clientIpAddress | | authenticatorAppGps | -## consentRequestFilterByCurrentUserOptions values +### consentRequestFilterByCurrentUserOptions values | Member | | | | reviewer | | unknownFutureValue | -## educationFeedbackResourceOutcomeStatus values +### educationFeedbackResourceOutcomeStatus values | Member | | | Namespace: microsoft.graph | failedPublish | | unknownFutureValue | -## externalEmailOtpState values +### externalEmailOtpState values | Member | | | Namespace: microsoft.graph | disabled | | unknownFutureValue | -## educationAddedStudentAction values +### educationAddedStudentAction values | Member | | | Namespace: microsoft.graph | assignIfOpen | | unknownFutureValue | -## educationModuleStatus values +### educationModuleStatus values | Member | | | | draft | | published | -## fido2RestrictionEnforcementType values +### fido2RestrictionEnforcementType values | Member | | | | allow | | block | -## x509CertificateAuthenticationMode values +### x509CertificateAuthenticationMode values | Member | | | Namespace: microsoft.graph | x509CertificateMultiFactor | | unknownFutureValue | -## x509CertificateRuleType values +### x509CertificateRuleType values | Member | | | Namespace: microsoft.graph | policyOID | | unknownFutureValue | -## attestationLevel values +### attestationLevel values | Member | | -- | | attested | | notAttested | -## authenticationMethodTargetType values +### authenticationMethodTargetType values | Member | | | | user | | group | -## authenticationMethodState values +### authenticationMethodState values | Member | | -- | | enabled | | disabled | -## microsoftAuthenticatorAuthenticationMode values +### microsoftAuthenticatorAuthenticationMode values | Member | | | Namespace: microsoft.graph | push | | deviceBasedPush | -## keyStrength values +### keyStrength values | Member | | - | Namespace: microsoft.graph | weak | | unknown | -## authenticationMethodKeyStrength values +### authenticationMethodKeyStrength values | Member | | - | Namespace: microsoft.graph | weak | | unknown | -## allowInvitesFrom values +### allowInvitesFrom values | Member | | -- | Namespace: microsoft.graph | everyone | | unknownFutureValue | -## dataPolicyOperationStatus values +### dataPolicyOperationStatus values | Member | | | Namespace: microsoft.graph | failed | | unknownFutureValue | -## conditionalAccessDevicePlatform values +### conditionalAccessDevicePlatform values | Member | | | Namespace: microsoft.graph | all | | unknownFutureValue | -## signinFrequencyType values +### signinFrequencyType values | Member | | | | days | | hours | -## persistentBrowserSessionMode values +### persistentBrowserSessionMode values | Member | | | | always | | never | -## cloudAppSecuritySessionControlType values +### cloudAppSecuritySessionControlType values | Member | | | Namespace: microsoft.graph | blockDownloads | | unknownFutureValue | -## conditionalAccessGrantControl values +### conditionalAccessGrantControl values | Member | | -- | Namespace: microsoft.graph | passwordChange | | unknownFutureValue | -## conditionalAccessClientApp values +### conditionalAccessClientApp values | Member | | | Namespace: microsoft.graph | other | | unknownFutureValue | -## conditionalAccessPolicyState values +### conditionalAccessPolicyState values | Member | | | Namespace: microsoft.graph | disabled | | enabledForReportingButNotEnforced | -## deviceProfileType values +### deviceProfileType values | Member | | - | Namespace: microsoft.graph | Shared | | IoT | -## appliedConditionalAccessPolicyResult values +### appliedConditionalAccessPolicyResult values | Member | | | Namespace: microsoft.graph | unknown | | unknownFutureValue | -## groupType values +### groupType values | Member | | | Namespace: microsoft.graph | azureAD | | unknownFutureValue | -## conditionalAccessStatus values +### conditionalAccessStatus values | Member | | | Namespace: microsoft.graph | notApplied | | unknownFutureValue | -## templateScenarios values +### templateScenarios values | Member | | | Namespace: microsoft.graph | emergingThreats | | unknownFutureValue | -## operationResult values +### operationResult values | Member | | | Namespace: microsoft.graph | timeout | | unknownFutureValue | -## tone values +### tone values | Member | | | Namespace: microsoft.graph | d | | flash | -## mediaState values +### mediaState values | Member | | | Namespace: microsoft.graph | inactive | | unknownFutureValue | -## basicStatus values +### basicStatus values | Member | | -- | | active | | inactive | -## callState values +### callState values | Member | | - | Namespace: microsoft.graph | terminating | | terminated | -## callType values +### callType values | Member | | | Namespace: microsoft.graph | peerToPeer | | unknownFutureValue | -## educationAddToCalendarOptions values +### educationAddToCalendarOptions values | Member | | | Namespace: microsoft.graph | unknownFutureValue | | studentsOnly | -## educationSubmissionStatus values +### educationSubmissionStatus values | Member | | | Namespace: microsoft.graph | unknownFutureValue | | reassigned | -## onlineMeetingRole values +### onlineMeetingRole values | Member | | | Namespace: microsoft.graph | presenter | | unknownFutureValue | -## modality values +### modality values | Member | | -- | Namespace: microsoft.graph | screenSharing | | unknownFutureValue | -## endpointType values +### endpointType values | Member | | - | Namespace: microsoft.graph | skypeForBusinessVoipPhone | | unknownFutureValue | -## callDirection values +### callDirection values | Member | | -- | | incoming | | outgoing | -## signInAudience values +### signInAudience values | Member | | - | Namespace: microsoft.graph | AzureADandPersonalMicrosoftAccount | | PersonalMicrosoftAccount | -## groupMembershipClaims values +### groupMembershipClaims values | Member | | - | Namespace: microsoft.graph | SecurityGroup | | All | -## recipientScopeType values +### recipientScopeType values | Member | | | Namespace: microsoft.graph | externalPartner | | externalNonPartner | -## activityType values +### activityType values | Member | | | Namespace: microsoft.graph | unknownFutureValue | | servicePrincipal | -## riskDetectionTimingType values +### riskDetectionTimingType values | Member | | | Namespace: microsoft.graph | offline | | unknownFutureValue | -## tokenIssuerType values +### tokenIssuerType values | Member | | -- | Namespace: microsoft.graph | ADFederationServices | | UnknownFutureValue | -## attachmentType values +### attachmentType values | Member | | | Namespace: microsoft.graph | item | | reference | -## contactRelationship values +### contactRelationship values | Member | Value | Description | | | -- | - | Namespace: microsoft.graph | other | 6 | An unspecified relationship to the user. | | unknownFutureValue | 7 | Marker value for future compatibility. | -## scheduleEntityTheme values +### scheduleEntityTheme values | Member | | -- | Namespace: microsoft.graph | darkYellow | | unknownFutureValue | -## timeOffReasonIconType values +### timeOffReasonIconType values | Member | | | Namespace: microsoft.graph | sunny | | unknownFutureValue | -## windowsSettingType values +### windowsSettingType values Possible types of Windows settings. Possible types of Windows settings. | backup | | unknownFutureValue | -## workforceIntegrationEncryptionProtocol values +### workforceIntegrationEncryptionProtocol values | Member | | -- | | sharedSecret | | unknownFutureValue | -## workforceIntegrationSupportedEntities values +### workforceIntegrationSupportedEntities values | Member | | -- | Possible types of Windows settings. | offerShiftRequest | | unknownFutureValue | -## timeZoneStandard values +### timeZoneStandard values | Member | | | | windows | | iana | -## freeBusyStatus values +### freeBusyStatus values | Member | Value | | - | -- | Possible types of Windows settings. | workingElsewhere | 4 | | unknown | -1 | -## attendeeType values +### attendeeType values | Member | | -- | Possible types of Windows settings. | optional | | resource | -## externalAudienceScope values +### externalAudienceScope values | Member | | -- | Possible types of Windows settings. | contactsOnly | | all | -## automaticRepliesStatus values +### automaticRepliesStatus values | Member | | -- | Possible types of Windows settings. | alwaysEnabled | | scheduled | -## calendarColor values +### calendarColor values | Member | Value | | -- | -- | Possible types of Windows settings. | lightRed | 8 | | maxColor | 9 | -## educationExternalSource values +### educationExternalSource values | Member | | | Possible types of Windows settings. | manual | | unknownFutureValue | -## educationGender values +### educationGender values | Member | | -- | Possible types of Windows settings. | other | | unknownFutureValue | -## eventType values +### eventType values | Member | | -- | Possible types of Windows settings. | exception | | seriesMaster | -## sensitivity values +### sensitivity values | Member | | -- | Possible types of Windows settings. | private | | confidential | -## importance values +### importance values | Member | | -- | Possible types of Windows settings. | normal | | high | -## educationUserRole values +### educationUserRole values | Member | | | Possible types of Windows settings. | none | | unknownFutureValue | -## meetingMessageType values +### meetingMessageType values | Member | | | Possible types of Windows settings. | meetingTenativelyAccepted | | meetingDeclined | -## followupFlagStatus values +### followupFlagStatus values | Member | | -- | Possible types of Windows settings. | complete | | flagged | -## inferenceClassificationType values +### inferenceClassificationType values | Member | | | | focused | | other | -## iosNotificationAlertType values +### iosNotificationAlertType values | Member | | -- | Possible types of Windows settings. | modal | | none | -## deviceEnrollmentFailureReason values +### deviceEnrollmentFailureReason values | Member | | -- | Possible types of Windows settings. | enrollmentRestrictionsEnforced | | clientDisconnected | -## bodyType values +### bodyType values | Member | | - | | text | | html | -## locationType values +### locationType values | Member | | -- | Possible types of Windows settings. | localBusiness | | postalAddress | -## locationUniqueIdType values +### locationUniqueIdType values | Member | | -- | Possible types of Windows settings. | private | | bing | -## messageActionFlag values +### messageActionFlag values | Member | | -- | Possible types of Windows settings. | replyToAll | | review | -## onenoteUserRole values +### onenoteUserRole values | Member | Value | | -- | -- | Possible types of Windows settings. | Reader | 2 | | None | -1 | -## operationStatus values +### operationStatus values | Member | | | Possible types of Windows settings. | Completed | | Failed | -## onenotePatchActionType values +### onenotePatchActionType values | Member | | -- | Possible types of Windows settings. | Insert | | Prepend | -## onenotePatchInsertPosition values +### onenotePatchInsertPosition values | Member | | -- | | After | | Before | -## phoneType values +### phoneType values | Member | | -- | Possible types of Windows settings. | pager | | radio | -## plannerContainerType values +### plannerContainerType values | Member | | | Possible types of Windows settings. | unknownFutureValue | | roster | -## plannerPreviewType values +### plannerPreviewType values | Member | | -- | Possible types of Windows settings. | description | | reference | -## status values +### status values | Member | | | Possible types of Windows settings. | ignored | | unknownFutureValue | -## weekIndex values +### weekIndex values | Member | | -- | Possible types of Windows settings. | fourth | | last | -## dayOfWeek values +### dayOfWeek values | Member | | -- | Possible types of Windows settings. | friday | | saturday | -## recurrenceRangeType values +### recurrenceRangeType values | Member | | -- | Possible types of Windows settings. | noEnd | | numbered | -## onenoteSourceService values +### onenoteSourceService values | Member | | - | Possible types of Windows settings. | OneDriveForBusiness | | OnPremOneDriveForBusiness | -## responseType values +### responseType values | Member | | -- | Possible types of Windows settings. | declined | | notResponded | -## activityDomain values +### activityDomain values | Member | | -- | Possible types of Windows settings. | personal | | unrestricted | -## websiteType values +### websiteType values | Member | | -- | Possible types of Windows settings. | blog | | profile | -## categoryColor values +### categoryColor values | Member | Value | | -- | -- | Possible types of Windows settings. | preset23 | 23 | | preset24 | 24 | -## alertFeedback values +### alertFeedback values Possible feedback values on the alert provided by an analyst. Possible feedback values on the alert provided by an analyst. | falsePositive | 2 | Alert is false-positive. | | benignPositive | 3 | Alert is benign-positive. | -## fileHashType values +### fileHashType values Enum for file hash types. Enum for file hash types. | peSha1 | 7 | PESHA1 hash type. | | peSha256 | 8 | PESHA256 hash type. | -## connectionDirection values +### connectionDirection values Enum for the direction of the network connection (inbound/outbound). Enum for the direction of the network connection (inbound/outbound). | inbound | 1 | Inbound connection. | | outbound | 2 | Outbound connection. | -## connectionStatus values +### connectionStatus values Enum for the status of connections. Enum for the status of connections. | blocked | 3 | Connection blocked. | | failed | 4 | Connection failed. | -## processIntegrityLevel values +### processIntegrityLevel values Possible integrity level values of the process. Possible integrity level values of the process. | high | 40 | Integrity level is High. | | system | 50 | Integrity level is System. | -## registryHive values +### registryHive values Enum for registry hives as defined by [/windows/desktop/sysinfo/registry-hives](/windows/desktop/sysinfo/registry-hives). Enum for registry hives as defined by [/windows/desktop/sysinfo/registry-hives]( | localMachineSystem | 5 | HKEY_LOCAL_MACHINE\System hive. | | usersDefault | 6 | HKEY_USERS\\.DEFAULT hive. | -## registryOperation values +### registryOperation values Operation that changed the registry key name and/or value. Operation that changed the registry key name and/or value. | modify | 2 | Modify registry. | | delete | 3 | Delete registry. | -## registryValueType values +### registryValueType values Enum for registry value types as defined by [/windows/desktop/sysinfo/registry-value-types](/windows/desktop/sysinfo/registry-value-types). Enum for registry value types as defined by [/windows/desktop/sysinfo/registry-v | qwordlittleEndian | 10 | REG_QWORD_LITTLE_ENDIAN registry value type. | | sz | 11 | REG_SZ registry value type. | -## alertSeverity values +### alertSeverity values Enum for severity of alerts. Enum for severity of alerts. | medium | 3 | Severity is medium. | | high | 4 | Severity is high. |