Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
102 changes: 102 additions & 0 deletions api-reference/beta/api/cloudpc-organizationaction.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
---
title: "cloudPC: organizationAction"
description: "Trigger a Cloud PC organization action."
author: "sqbing"
ms.localizationpriority: medium
ms.subservice: "cloud-pc"
doc_type: apiPageType
ms.date: 02/12/2026
---

# cloudPC: organizationAction

Namespace: microsoft.graph

[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]

Trigger a Cloud PC organization action.


## 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": "cloudpc_organizationaction" } -->
[!INCLUDE [permissions-table](../includes/permissions/cloudpc-organizationaction-permissions.md)]

## HTTP request

<!-- {
"blockType": "ignored"
}
-->

To trigger a Cloud PC organization action using delegated permission:

```http
POST /deviceManagement/virtualEndpoint/organizationAction
```

## Request headers

|Name|Description|
|:---|:---|
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
|Content-Type|application/json. Required.|

## Request body

In the request body, supply a JSON representation of the parameters.

The following table shows the parameter that you can use with this action.

|Parameter|Type|Description|
|:---|:---|:---|
|actionType|[cloudPcOrganizationActionType](../resources/cloudpcorganizationactiondetail.md#cloudpcorganizationactiontype-values)|The action type. Possible values are `activate`, `deactivate`, and `unknownFutureValue`. Required.|

## Response

If successful, this method returns a `200 OK` response code and a [cloudPcOrganizationActionDetail](../resources/cloudpcorganizationactiondetail.md) object in the response body.

## Example

### Request

The following example shows a request.

<!-- {
"blockType": "request",
"name": "cloudpc_organizationaction"
} -->

```http
POST https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/organizationAction
Content-Type: application/json

{
"actionType": "activate"
}
```

### Response

The following example shows the response.

<!-- {
"blockType": "response",
"truncated": true,
"@odata.type": "microsoft.graph.cloudPcOrganizationActionDetail"
}
-->

```http
HTTP/1.1 200 OK
Content-Type: application/json

{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.cloudPcOrganizationActionDetail",
"actionType": "activate",
"status": "inProgress",
"errorDescription": null
}
```
97 changes: 97 additions & 0 deletions api-reference/beta/api/cloudpc-retrieveorganizationactiondetail.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
---
title: "cloudPC: retrieveOrganizationActionDetail"
description: "Retrieve a Cloud PC organization action detail."
author: "sqbing"
ms.localizationpriority: medium
ms.subservice: "cloud-pc"
doc_type: apiPageType
ms.date: 02/12/2026
---

# cloudPC: retrieveOrganizationActionDetail

Namespace: microsoft.graph

[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]

Retrieve the details of a [cloudPcOrganizationActionDetail](../resources/cloudpcorganizationactiondetail.md).


## Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).

<!-- { "blockType": "permissions", "name": "cloudpc_retrieveorganizationactiondetail" } -->
[!INCLUDE [permissions-table](../includes/permissions/cloudpc-retrieveorganizationactiondetail-permissions.md)]

## HTTP request

<!-- {
"blockType": "ignored"
}
-->

To retrieve a Cloud PC organization action detail using delegated permission:

```http
GET /deviceManagement/virtualEndpoint/retrieveOrganizationActionDetail(actionType='{actionType}')
```

## Function parameters

|Parameter|Type|Description|
|:---|:---|:---|
|actionType|[cloudPcOrganizationActionType](../resources/cloudpcorganizationactiondetail.md#cloudpcorganizationactiontype-values)|The action type. Possible values are `activate`, `deactivate`, and `unknownFutureValue`. Required.|

## 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 function returns a `200 OK` response code and a [cloudPcOrganizationActionDetail](../resources/cloudpcorganizationactiondetail.md) object in the response body.

## Example

### Request

The following example shows a request.

<!-- {
"blockType": "request",
"name": "cloudpc_retrieveorganizationactiondetail"
} -->

```http
GET https://graph.microsoft.com/beta/deviceManagement/virtualEndpoint/retrieveOrganizationActionDetail(actionType='activate')
```


### Response

The following example shows the response.

<!-- {
"blockType": "response",
"truncated": true,
"@odata.type": "microsoft.graph.cloudPcOrganizationActionDetail"
}
-->

```http
HTTP/1.1 200 OK
Content-Type: application/json

{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.cloudPcOrganizationActionDetail",
"actionType": "activate",
"status": "inProgress",
"errorDescription": null
}
```
148 changes: 148 additions & 0 deletions api-reference/beta/api/user-list-sponsorof.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,148 @@
---
title: "List sponsorOf"
description: "Get the list of directory objects that a user sponsors."
author: "Jackson-Woods"
ms.localizationpriority: medium
ms.subservice: entra-users
doc_type: apiPageType
ms.date: 07/08/2026
---

# List sponsorOf

<!-- markdownlint-disable MD024 -->

Namespace: microsoft.graph

[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]

Get the directory objects that a user sponsors. Sponsored objects can include users, agent users, agent blueprints, agent blueprint principals, and agent identities. Because a group can also be a sponsor, the response includes both objects the user directly sponsors and objects the user sponsors through group membership.

## 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": "user_list_sponsorof" } -->
[!INCLUDE [permissions-table](../includes/permissions/user-list-sponsorof-permissions.md)]

## HTTP request

<!-- { "blockType": "ignored" } -->
```http
GET /me/sponsorOf
GET /users/{id | userPrincipalName}/sponsorOf
```

## Optional query parameters

This method supports the `$filter`, `$count`, `$select`, `$expand`, `$top`, and `$skip` [OData query parameters](/graph/query-parameters) to help customize the response.

## Request headers

| Header | Value |
|:--------------|:------|
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |

## Request body

Don't supply a request body for this method.

## Response

If successful, this method returns a `200 OK` response code and a collection of [directoryObject](../resources/directoryobject.md) objects in the response body.

## Examples

### Example 1: List all entities that a user sponsors

#### Request

The following example shows a request.
<!-- {
"blockType": "request",
"name": "get_sponsorof"
}
-->
```http
GET https://graph.microsoft.com/beta/users/025e5e3e-e5b7-4eb4-ba1f-4e5b0579f1a2/sponsorOf
```

#### 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.directoryObject",
"isCollection": true
}
-->
```http
HTTP/1.1 200 OK
Content-Type: application/json

{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
"value": [
{
"@odata.type": "#microsoft.graph.user",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"displayName": "Guest User 1",
"userPrincipalName": "guestuser1_example.com#EXT#@contoso.onmicrosoft.com",
"userType": "Guest"
},
{
"@odata.type": "#microsoft.graph.user",
"id": "2fe96d23-5dc6-4f35-8222-0426a8c115c6",
"displayName": "Guest User 2",
"userPrincipalName": "guestuser2_example.com#EXT#@contoso.onmicrosoft.com",
"userType": "Guest"
}
]
}
```

### Example 2: List all entities that a user sponsors, filtered by type

#### Request

The following example shows a request that filters the sponsored objects by user type.
<!-- {
"blockType": "request",
"name": "get_sponsorof_filter"
}
-->
```http
GET https://graph.microsoft.com/beta/users/025e5e3e-e5b7-4eb4-ba1f-4e5b0579f1a2/sponsorOf?$filter=microsoft.graph.user/userType eq 'Guest'
ConsistencyLevel: eventual
```

#### 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.directoryObject",
"isCollection": true
}
-->
```http
HTTP/1.1 200 OK
Content-Type: application/json

{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#directoryObjects",
"value": [
{
"@odata.type": "#microsoft.graph.user",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"displayName": "Guest User 1",
"userPrincipalName": "guestuser1_example.com#EXT#@contoso.onmicrosoft.com",
"userType": "Guest"
}
]
}
```
4 changes: 2 additions & 2 deletions api-reference/beta/api/virtualendpoint-list-serviceplans.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,9 @@ Namespace: microsoft.graph

[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]

List the currently available service plans that an organization can purchase for their Cloud PCs.
List the currently available [service plans](../resources/cloudpcserviceplan.md) that an organization can purchase for their Cloud PCs.

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.

[!INCLUDE [national-cloud-support](../../includes/global-us-l4.md)]

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
description: "Automatically generated file. DO NOT MODIFY"
ms.topic: include
ms.localizationpriority: medium
---

|Permission type|Least privileged permissions|Higher privileged permissions|
|:---|:---|:---|
|Delegated (work or school account)|CloudPC.ReadWrite.All|Not available.|
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
|Application|Not supported.|Not supported.|

Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
description: "Automatically generated file. DO NOT MODIFY"
ms.topic: include
ms.localizationpriority: medium
---

|Permission type|Least privileged permissions|Higher privileged permissions|
|:---|:---|:---|
|Delegated (work or school account)|CloudPC.ReadWrite.All|Not available.|
|Delegated (personal Microsoft account)|Not supported.|Not supported.|
|Application|Not supported.|Not supported.|

Loading
Loading