Skip to content

Commit

Permalink
Merge pull request #23258 from microsoftgraph/main
Browse files Browse the repository at this point in the history
Merge to publish
  • Loading branch information
jasonjoh authored Dec 21, 2023
2 parents 45b9201 + f9b9078 commit 9698d7c
Show file tree
Hide file tree
Showing 263 changed files with 4,223 additions and 388 deletions.
168 changes: 168 additions & 0 deletions api-reference/beta/api/changetrackedentity-stagefordeletion.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
---
title: "changeTrackedEntity: stageForDeletion"
description: "Stage the deletion of an openShift, shift, or timeOff instance in a [schedule](../resources/schedule.md) in draft mode."
author: "raulfernandes"
ms.localizationpriority: medium
ms.prod: "microsoft-teams"
doc_type: apiPageType
---

# changeTrackedEntity: stageForDeletion

Namespace: microsoft.graph

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

Stage the deletion of an [openShift](../resources/openshift.md), [shift](../resources/shift.md), or [timeOff](../resources/timeoff.md) instance in a [schedule](../resources/schedule.md) in draft mode.

Draft changes are only visible to managers. Team members are not sent notification for draft changes. The deletion is finalized when the schedule is [shared](../api/schedule-share.md).

## Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

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

## HTTP request

For an **openShift**:
<!-- {
"blockType": "ignored"
}
-->
``` http
POST /teams/{teamsId}/schedule/openShifts/{openShiftId}/stageForDeletion
```

For a **shift**:
<!-- {
"blockType": "ignored"
}
-->
``` http
POST /teams/{teamsId}/schedule/shifts/{shiftId}/stageForDeletion
```

For a **timeOff**:
<!-- {
"blockType": "ignored"
}
-->
``` http
POST /teams/{teamsId}/schedule/timesOff/{timeOffId}/stageForDeletion
```

## Request headers

|Name|Description|
|:---|:---|
|Authorization|Bearer {token}. Required.|
| MS-APP-ACTS-AS | A user ID (GUID). Required only if the authorization token is an application token; otherwise, optional. |

## Request body

Don't supply a request body for this method.

## Response

If successful, this method returns a `204 No Content` response code.

## Examples

### Example 1: Stage the deletion of an openShift

The following example shows how to stage the deletion of an **openShift** in a **schedule** in draft mode.

#### Request

The following example shows a request.

<!-- {
"blockType": "request",
"name": "openshift.stagefordeletion",
"sampleKeys": ["3d88b7a2-f988-4f4b-bb34-d66df66af126", "OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8"]
}
-->
``` http
POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/openShifts/OPNSHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion
```

#### Response

The following example shows the response.

<!-- {
"blockType": "response",
"truncated": true
}
-->
``` http
HTTP/1.1 204 No Content
```

### Example 2: Stage the deletion of a shift

The following example shows how to stage the deletion of a **shift** in a **schedule** in draft mode.

#### Request

The following example shows a request.

<!-- {
"blockType": "request",
"name": "shift.stagefordeletion",
"sampleKeys": ["3d88b7a2-f988-4f4b-bb34-d66df66af126", "SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8"]
}
-->
``` http
POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/shifts/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion
```

#### Response

The following example shows the response.

<!-- {
"blockType": "response",
"truncated": true
}
-->
``` http
HTTP/1.1 204 No Content
```

### Example 3: Stage the deletion of a timeOff

The following example shows how to stage the deletion of a **timeOff** in a **schedule** in draft mode.

#### Request

The following example shows a request.

<!-- {
"blockType": "request",
"name": "timeoff.stagefordeletion",
"sampleKeys": ["3d88b7a2-f988-4f4b-bb34-d66df66af126", "SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8"]
}
-->
``` http
POST https://graph.microsoft.com/beta/teams/3d88b7a2-f988-4f4b-bb34-d66df66af126/schedule/timesOff/SHFT_577b75d2-a927-48c0-a5d1-dc984894e7b8/stageForDeletion
```

#### Response

The following example shows the response.

<!-- {
"blockType": "response",
"truncated": true
}
-->
``` http
HTTP/1.1 204 No Content
```
31 changes: 31 additions & 0 deletions api-reference/beta/api/community-get.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,7 @@ If successful, this method returns a `200 OK` response code and a [community](..

The following example shows a request.

# [HTTP](#tab/http)
<!-- {
"blockType": "request",
"name": "get_community",
Expand All @@ -70,6 +71,36 @@ The following example shows a request.
GET https://graph.microsoft.com/beta/employeeExperience/communities/eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI4MzIxMjc1In0
```

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/get-community-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [CLI](#tab/cli)
[!INCLUDE [sample-code](../includes/snippets/cli/get-community-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/get-community-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/get-community-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/get-community-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [PHP](#tab/php)
[!INCLUDE [sample-code](../includes/snippets/php/get-community-php-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Python](#tab/python)
[!INCLUDE [sample-code](../includes/snippets/python/get-community-python-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

### Response

The following example shows the response.
Expand Down
1 change: 0 additions & 1 deletion api-reference/beta/api/daynote-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,6 @@ Content-Type: application/json

---


### Response
The following example shows the response.

Expand Down
8 changes: 8 additions & 0 deletions api-reference/beta/api/devicemanagement-alertrule-post.md
Original file line number Diff line number Diff line change
Expand Up @@ -125,6 +125,14 @@ Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/cli/post-alertrule-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/post-alertrule-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/post-alertrule-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/post-alertrule-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Expand Down
8 changes: 8 additions & 0 deletions api-reference/beta/api/devicemanagement-alertrule-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,14 @@ Content-Type: application/json
[!INCLUDE [sample-code](../includes/snippets/cli/update-alertrule-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/update-alertrule-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/update-alertrule-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/update-alertrule-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Expand Down
4 changes: 4 additions & 0 deletions api-reference/beta/api/deviceregistrationpolicy-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,10 @@ Content-Type: application/json
}
```

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/update-deviceregistrationpolicy-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/update-deviceregistrationpolicy-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
Expand Down
62 changes: 62 additions & 0 deletions api-reference/beta/api/employeeexperience-post-communities.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,7 @@ If successful, this method returns a `202 Accepted` response code. The response

The following example shows a request with delegated permissions. When the **owners** property isn't specified in the request body, the calling user is automatically assigned as the community owner.

# [HTTP](#tab/http)
<!-- {
"blockType": "request",
"name": "create_community_from_minimal_e1"
Expand All @@ -83,6 +84,36 @@ Content-Type: application/json
}
```

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/create-community-from-minimal-e1-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [CLI](#tab/cli)
[!INCLUDE [sample-code](../includes/snippets/cli/create-community-from-minimal-e1-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/create-community-from-minimal-e1-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/create-community-from-minimal-e1-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/create-community-from-minimal-e1-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [PHP](#tab/php)
[!INCLUDE [sample-code](../includes/snippets/php/create-community-from-minimal-e1-php-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Python](#tab/python)
[!INCLUDE [sample-code](../includes/snippets/python/create-community-from-minimal-e1-python-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

#### Response

The following example shows the response.
Expand All @@ -106,6 +137,7 @@ Operation-Location: https://graph.microsoft.com/beta/employeeExperience/engageme

The following example shows a minimal request that requires application permissions. If the **owners** property isn't specified in the request body, the request fails.

# [HTTP](#tab/http)
<!-- {
"blockType": "request",
"name": "create_community_from_app_only_e2"
Expand All @@ -125,6 +157,36 @@ Content-Type: application/json
}
```

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/create-community-from-app-only-e2-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [CLI](#tab/cli)
[!INCLUDE [sample-code](../includes/snippets/cli/create-community-from-app-only-e2-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/create-community-from-app-only-e2-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/create-community-from-app-only-e2-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/create-community-from-app-only-e2-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [PHP](#tab/php)
[!INCLUDE [sample-code](../includes/snippets/php/create-community-from-app-only-e2-php-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Python](#tab/python)
[!INCLUDE [sample-code](../includes/snippets/python/create-community-from-app-only-e2-python-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

#### Response

The following example shows the response.
Expand Down
31 changes: 31 additions & 0 deletions api-reference/beta/api/engagementasyncoperation-get.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,7 @@ If successful, this method returns a `200 OK` response code and an [engagementAs

The following example shows a request.

# [HTTP](#tab/http)
<!-- {
"blockType": "request",
"name": "get_engagementasyncoperation"
Expand All @@ -69,6 +70,36 @@ The following example shows a request.
GET https://graph.microsoft.com/beta/employeeExperience/engagementAsyncOperations/a6fdce1-c261-48bc-89de-1cfef658c0d5
```

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/get-engagementasyncoperation-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [CLI](#tab/cli)
[!INCLUDE [sample-code](../includes/snippets/cli/get-engagementasyncoperation-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/get-engagementasyncoperation-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/get-engagementasyncoperation-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/get-engagementasyncoperation-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [PHP](#tab/php)
[!INCLUDE [sample-code](../includes/snippets/php/get-engagementasyncoperation-php-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Python](#tab/python)
[!INCLUDE [sample-code](../includes/snippets/python/get-engagementasyncoperation-python-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

### Response

The following example shows the response.
Expand Down
Loading

0 comments on commit 9698d7c

Please sign in to comment.