| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| v1.0 | Organization Activateservice | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/organization-activateservice.md | - Title: "organization: activateService" -description: "Activates a service for an organization." --doc_type: apiPageType ---# organization: activateService (deprecated) --Namespace: microsoft.graph ---> [!CAUTION] -> The **activateService** API is deprecated and will stop returning data on June 30, 2022. --Activate a service for an organization. --## 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). --In order to activate a service for an organization the requestor needs to have the _Company Administrator_ role with the following permissions. --|Permission type|Permissions (from least to most privileged)| -| : | : | -| Delegated (work or school account) | Directory.ReadWrite.All| -| Delegated (personal Microsoft account) | Not Supported. | -| Application | Directory.ReadWrite.All| ---## HTTP request --<!-- { - "blockType": "ignored" -} >-``` http -POST /organization/{organizationId}/activateService -``` --## Request headers -|Name|Description| -|:|:| -|Authorization|Bearer {token}. Required.| -|Content-Type|application/json. Required.| --## Request body -In the request body, supply a JSON representation of the [activateService](../resources/activateService.md) object. -You must define **service** or (**servicePlanId** _and_ **skuId**) for this action to be valid. --| Property | Type | Description | -| -- | | - | -| service| String | The name of the service to activate. | -| servicePlanId | Guid | The plan identifier of the service plan to activate. | -| skuId | Guid | The SKU identifier of the service plan. | --## Response --If successful, this action returns a `204 No Content` response code. --## Examples --### Request --# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "organization_activateservice" -} >-``` http -POST https://graph.microsoft.com/beta/organization/{:organizationId}/activateService -Content-Type: application/json --{ - "skuId": "6fd2c87f-b296-42f0-b197-1e91e994b900", - "servicePlanId": "a23b959c-7ce8-4e57-9140-b90eb88a9e97" -} -``` --# [JavaScript](#tab/javascript) ----### Response -<!-- { - "blockType": "response", - "truncated": true -} >-``` http -HTTP/1.1 204 No Content -``` |
| v1.0 | Plannerbucket Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/plannerbucket-get.md | Title: "Get plannerBucket" -description: "Retrieve the properties and relationships of **plannerBucket** object." +description: "Retrieve the properties and relationships of a plannerBucket object." ms.localizationpriority: medium ms.prod: "planner" Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Retrieve the properties and relationships of **plannerBucket** object. +Retrieve the properties and relationships of a [plannerBucket](../resources/plannerbucket.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). Do not supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and [plannerBucket](../resources/plannerbucket.md) object in the response body. +If successful, this method returns a `200 OK` response code and a [plannerBucket](../resources/plannerbucket.md) object in the response body. This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example-##### Request -Here is an example of the request. +### Request +The following is an example of the request. # [HTTP](#tab/http) <!-- { GET https://graph.microsoft.com/beta/planner/buckets/hsOf2dhOJkqyYYZEtdzDe2QAIUC -##### Response -Here is an example of the response. Note: The response object shown here might be shortened for readability. +### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, Content-type: application/json ] } -->-- |
| v1.0 | User Activateserviceplan | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/user-activateserviceplan.md | - Title: "user: activateServicePlan" -description: "Activate a service plan with a given `servicePlanId` and `skuId` for a given user." --doc_type: apiPageType ---# user: activateServicePlan (deprecated) --Namespace: microsoft.graph ---> [!CAUTION] -> The **activateServicePlan** API is deprecated and will stop returning data on June 30, 2022. --Activate a service plan with a given `servicePlanId` and `skuId` for a given user. --## Permissions --One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). --|Permission type|Permissions (from most to least privileged)| -| : | : | -| Delegated (work or school account) | Directory.ReadWrite.All | -| Delegated (personal Microsoft account) | Not Supported. | -| Application | Directory.ReadWrite.All | --## HTTP request --<!-- { - "blockType": "ignored" -} >--``` http -POST /users/{id | userPrincipalName}/activateServicePlan -``` --## Request headers --| Name | Description | -| : | : | -| Authorization | Bearer {token}. Required. | -| Content-Type | application/json. Required. | --## Request body --In the request body, provide a JSON object with the following parameter: --| Parameter | Type | Description | -| : | : | : | -| servicePlanId | Guid | PlanId of the ServicePlan to activate. | -| skuId | Guid | SkuId of SKU the service plan is on. | --## Response --If successful, this action returns a `204 No Content` response code. --## Examples --### Request ---# [HTTP](#tab/http) -<!-- { - "blockType": "request", - "name": "user_activateserviceplan" -} >--``` http -POST https://graph.microsoft.com/beta/me/activateServicePlan -Content-type: application/json --{ - "servicePlanId": "28f42d6f-8034-4a0f-9d8a-a218a63b3299", - "skuId": "465a2a90-5e59-456d-a7b8-127b9fb2e484" -} -``` --# [JavaScript](#tab/javascript) ----### Response --<!-- { - "blockType": "response", - "truncated": true -} >--``` http -HTTP/1.1 204 No Content -``` |
| v1.0 | Workflow List Executionscope | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/workflow-list-executionscope.md | Namespace: microsoft.graph.identityGovernance [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Lists the users who are in the scope of the execution conditions of a [workflow](../resources/identitygovernance-workflow.md). Users who initially fall in the scope of the execution conditions, but are updated to no longer meet the conditions after it's scheduled to run, will remain on the list for a short period of time before being removed. If the execution scope is changed, users who initially met it's conditions, but no longer do so will be cleared from the list after a short period of time. New users who meet the conditions for the workflow will then be listed. +List the users that meet the [execution conditions](../resources/identitygovernance-workflowexecutionconditions.md) regardless of whether they have already been processed by the [workflow](../resources/identitygovernance-workflow.md). -This API call requires workflow scheduling to be enabled. +The workflow engine periodically evaluates the users that meet the execution conditions. The results will not be up to date if the execution conditions have been changed recently, relevant attributes on the user have been changed recently or the [time based trigger](../resources/identitygovernance-timebasedattributetrigger.md) has been reached recently. ++The API is only supported for workflows with [trigger and scope based](../resources/identitygovernance-triggerandscopebasedconditions.md) [execution conditions](../resources/identitygovernance-workflowexecutionconditions.md). Furthermore, results are only returned if the workflows schedule (isSchedulingEnabled) is enabled. ## Permissions |
| v1.0 | Activateservice | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/activateservice.md | - Title: "activateService resource type" -description: "Represents a service to be activated." --doc_type: apiPageType ---# activateService resource type (deprecated) --Namespace: microsoft.graph ---Represents a service to be activated. --## Properties --| Property | Type | Description | -| -- | | - | -| service| String | The name of the service to activate. | -| servicePlanId | Guid | The plan identifier of the service plan to activate. | -| skuId | Guid | The SKU identifier of the service plan. | --## JSON representation --Here is a JSON representation of the resource. --<!-- { - "blockType": "resource", - "optionalProperties": [ -- ], - "@odata.type": "microsoft.graph.activateService" -}--> --```json -{ - "service": "String", - "skuId": "Guid", - "servicePlanId": "Guid" -} --``` --<!-- uuid: 20fd7863-9545-40d4-ae8f-fee2d115a690 -2015-10-25 14:57:30 UTC --> -<!-- -{ - "type": "#page.annotation", - "description": "activateService", - "keywords": "", - "section": "documentation", - "tocPath": "", - "suppressions": [] -} > |
| v1.0 | Cloudpcserviceplan | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/cloudpcserviceplan.md | Title: "cloudPcServicePlan resource type" -description: "Represents a Windows 365 service plan configured for a Cloud PC." +description: "Represents a Windows 365 service plan that can be purchased and configured for a Cloud PC." ms.localizationpriority: medium ms.prod: "cloud-pc" Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Represents a Windows 365 service plan configured for a Cloud PC. +Represents a Windows 365 service plan that can be purchased and configured for a Cloud PC. -For examples of currently available service plans, see [Windows 365 compare plans and pricing](https://www.microsoft.com/windows-365/business/compare-plans-pricing). Currently, Microsoft Graph API is available for Windows 365 Enterprise. +For examples of currently available service plans, see [Windows 365 compare plans and pricing](https://www.microsoft.com/windows-365/business/compare-plans-pricing). Currently, the Microsoft Graph API is available for Windows 365 Enterprise. ## Methods |
| v1.0 | Organization | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/organization.md | This resource lets you add your own data to custom properties using [extensions] |[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.| |**Schema extensions**| | | |[Add schema extension values](../api/schemaextension-post-schemaextensions.md) | [schemaExtension](schemaextension.md) | Create a schema extension definition and then use it to add custom typed data to a resource.|-|**Organization licenses**| | | -|[activateService](../api/organization-activateservice.md) (deprecated) | None | Activate a service for an organization. | |**Organizational branding**| | | |[Get organizationalBranding](../api/organizationalbranding-get.md) | [organizationalBranding](organizationalbranding.md) | Get the default organizational branding object. | |[Update organizationalBranding](../api/organizationalbranding-update.md) | [organizationalBranding](organizationalbranding.md) | Update the default organizational branding object. | |
| v1.0 | Security Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/security-api-overview.md | Alerts from the following security providers are available via this legacy **ale | Security provider | <p align="center">GET alert</p>| <p align="center">PATCH alert</p>| <p align="center">Subscribe to alert</p>| |:|:|:--|:|-|[Azure Active Directory Identity Protection](/azure/active-directory/identity-protection/playbook) **** | <p align="center">✓</p> | <p align="center">[File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) *</p> | <p align="center">✓</p> | +|[Azure Active Directory Identity Protection](/azure/active-directory/identity-protection/playbook) | <p align="center">✓</p> | <p align="center">[File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) *</p> | <p align="center">✓</p> | |[Azure Security Center](/azure/security-center/security-center-alerts-type)| <p align="center">✓</p> | <p align="center">✓</p> | <p align="center">✓</p> | |Microsoft 365 <ul><li> [Default](/office365/securitycompliance/alert-policies#default-alert-policies)</li> <li>[Cloud App Security](/office365/securitycompliance/anomaly-detection-policies-in-ocas)</li><li>Custom Alert</li></ul> | <p align="center">✓</p> | <p align="center"> [File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) </p> | <p align="center"> [File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) </p> | | [Microsoft Defender for Cloud Apps](/cloud-app-security/monitor-alerts) (formerly Microsoft Cloud App Security) | <p align="center">✓</p> | <p align="center">[File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) *</p> | <p align="center">✓</p> | Alerts from the following security providers are available via this legacy **ale \*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you will get Microsoft Defender for Identity alerts only if you have joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/azure-advanced-threat-protection/atp-mcas-integration). -\*\*\*\* Azure AD Identity Protection alerts only include user object IDs. The **userPrincipalName** (UPN) property is not included in GET request responses. This issue does not impact any of the other providers. For details and a workaround, see [Known issues](/graph/known-issues#upn-missing-in-identity-protection-security-alerts). - ## Attack simulation and training [Attack simulation and training](/microsoft-365/security/office-365-security/attack-simulation-training) is part of [Microsoft Defender for Office 365](/microsoft-365/security/office-365-security/defender-for-office-365?view=o365-worldwide&preserve-view=true). This service lets users in a tenant experience a realistic benign phishing attack and learn from it. Social engineering simulation and training experiences for end users help reduce the risk of users being breached via those attack techniques. The attack simulation and training API enables tenant administrators to view launched [simulation](simulation.md) exercises and trainings, and get [reports](report-m365defender-reports-overview.md) on derived insights into online behaviors of users in the phishing simulations. |
| v1.0 | User | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/user.md | This resource supports: | [Get deleted user](../api/directory-deleteditems-get.md) | [directoryObject](directoryobject.md) collection | Retrieve a deleted user by ID. | | [Restore deleted user](../api/directory-deleteditems-delete.md) | [directoryObject](directoryobject.md) collection | Restore a user deleted in the tenant in the last 30 days. | | [Permanently delete user](../api/directory-deleteditems-restore.md) | [directoryObject](directoryobject.md) collection | Permanently delete a deleted user from the tenant. |-| [activateServicePlan](../api/user-activateserviceplan.md) (deprecated) | None | Activate a service with a given `servicePlanId` and `skuId` for a given [user](user.md). | | **Drive** ||| | [Get drive](../api/drive-get.md) | [drive](drive.md) | Retrieve the properties and relationships of a Drive resource. | | [List children](../api/driveitem-list-children.md) | [DriveItems](driveitem.md) | Return a collection of DriveItems in the children relationship of a DriveItem. | |
| v1.0 | Plannerbucket Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/plannerbucket-get.md | Title: "Get plannerBucket" -description: "Retrieve the properties and relationships of **plannerBucket** object." +description: "Retrieve the properties and relationships of a plannerBucket object." ms.localizationpriority: medium ms.prod: "planner" doc_type: apiPageType Namespace: microsoft.graph -Retrieve the properties and relationships of **plannerBucket** object. +Retrieve the properties and relationships of a [plannerBucket](../resources/plannerbucket.md) object. + ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference). Do not supply a request body for this method. ## Response -If successful, this method returns a `200 OK` response code and [plannerBucket](../resources/plannerbucket.md) object in the response body. +If successful, this method returns a `200 OK` response code and a [plannerBucket](../resources/plannerbucket.md) object in the response body. This method can return any of the [HTTP status codes](/graph/errors). The most common errors that apps should handle for this method are the 403 and 404 responses. For more information about these errors, see [Common Planner error conditions](../resources/planner-overview.md#common-planner-error-conditions). ## Example-##### Request -Here is an example of the request. +### Request +The following is an example of the request. # [HTTP](#tab/http) <!-- { "blockType": "request",- "name": "get_plannerbucket" + "name": "get_plannerbucket", + "sampleKeys": ["hsOf2dhOJkqyYYZEtdzDe2QAIUCR"] }--> ```msgraph-interactive-GET https://graph.microsoft.com/v1.0/planner/buckets/{bucket-id} +GET https://graph.microsoft.com/v1.0/planner/buckets/hsOf2dhOJkqyYYZEtdzDe2QAIUCR ``` # [C#](#tab/csharp) GET https://graph.microsoft.com/v1.0/planner/buckets/{bucket-id} -##### Response -Here is an example of the response. Note: The response object shown here might be shortened for readability. +### Response +The following is an example of the response. +>**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", "truncated": true, Content-type: application/json "suppressions": [ ] }-->- |
| v1.0 | Profilephoto Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/profilephoto-update.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Group.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Group.ReadWrite.All | +|Application | Not supported. | ### To update the profile photo of a team |
| v1.0 | Security Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/security-api-overview.md | Alerts from the following providers are available via this **alert** resource. S | Security provider | <p align="center">GET alert</p>| <p align="center">PATCH alert</p>| <p align="center">Subscribe to alert</p>| |:|:|:--|:|-|[Azure Active Directory Identity Protection](/azure/active-directory/identity-protection/playbook) ****| <p align="center">✓</p> | <p align="center">[File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) *</p> | <p align="center">✓</p> | +|[Azure Active Directory Identity Protection](/azure/active-directory/identity-protection/playbook) | <p align="center">✓</p> | <p align="center">[File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) *</p> | <p align="center">✓</p> | |Microsoft 365 <ul><li> [Default](/office365/securitycompliance/alert-policies#default-alert-policies)</li> <li>[Cloud App Security](/office365/securitycompliance/anomaly-detection-policies-in-ocas)</li><li>Custom Alert</li></ul> | <p align="center">✓</p> | <p align="center"> [File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) </p> | <p align="center"> [File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) </p> | | [Microsoft Defender for Cloud Apps](/cloud-app-security/monitor-alerts) | <p align="center">✓</p> | <p align="center">[File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) *</p> | <p align="center">✓</p> | |[Microsoft Defender for Endpoint](/windows/security/threat-protection/microsoft-defender-atp/attack-simulations) **| <p align="center">✓</p> | <p align="center">✓</p> | <p align="center"> [File issue](https://github.com/microsoftgraph/security-api-solutions/issues/new) </p> | Alerts from the following providers are available via this **alert** resource. S \*\*\* Microsoft Defender for Identity alerts are available via the Microsoft Defender for Cloud Apps integration. This means you will get Microsoft Defender for Identity alerts only if you have joined Unified SecOps and connected Microsoft Defender for Identity into Microsoft Defender for Cloud Apps. Learn more about [how to integrate Microsoft Defender for Identity and Microsoft Defender for Cloud Apps](/defender-for-identity/mcas-integration). -\*\*\*\* Azure AD Identity Protection alerts only include user object IDs. The┬á**userPrincipalName** (UPN) property is not included in GET request responses.┬áThis issue does not impact any of the other providers. For details and a workaround, see [Known issues](/graph/known-issues#upn-missing-in-identity-protection-security-alerts). - ## Attack simulation and training [Attack simulation and training](/microsoft-365/security/office-365-security/attack-simulation-training) is part of [Microsoft Defender for Office 365](/microsoft-365/security/office-365-security/defender-for-office-365?view=o365-worldwide&preserve-view=true). This service lets users in a tenant experience a realistic benign phishing attack and learn from it. Social engineering simulation and training experiences for end users help reduce the risk of users being breached via those attack techniques. The attack simulation and training API enables tenant administrators to view launched [simulation](simulation.md) exercises and trainings, and get [reports](report-m365defender-reports-overview.md) on derived insights into online behaviors of users in the phishing simulations. |