Skip to content

Commit b39e878

Browse files
FaithOmbongiFaithOmbongi
authored
Merge pull request #26122 from microsoftgraph/users/lemike/timecardDaynote
Promote timeCard, dayNote to v1
2 parents ba9b69a + 03fa0d8 commit b39e878

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

56 files changed

+2461
-64
lines changed

‎api-reference/v1.0/api/daynote-get.md

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: "Get dayNote"
3+
description: "Read the properties and relationships of a dayNote object."
4+
author: lemike
5+
ms.date: 01/17/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: teams
8+
doc_type: apiPageType
9+
---
10+
11+
# Get dayNote
12+
13+
Namespace: microsoft.graph
14+
15+
Read the properties and relationships of a [dayNote](../resources/daynote.md) object.
16+
17+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "daynote-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/daynote-get-permissions.md)]
29+
30+
## HTTP request
31+
32+
<!-- {
33+
"blockType": "ignored"
34+
}
35+
-->
36+
``` http
37+
GET /teams/{teamsId}/schedule/dayNotes/{dayNoteId}
38+
```
39+
40+
## Request headers
41+
42+
|Name|Description|
43+
|:---|:---|
44+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
45+
46+
## Request body
47+
48+
Don't supply a request body for this method.
49+
50+
## Response
51+
52+
If successful, this method returns a `200 OK` response code and a [dayNote](../resources/daynote.md) object in the response body.
53+
54+
## Examples
55+
56+
### Request
57+
The following example shows a request.
58+
59+
``` http
60+
GET /teams/d72f9b8e-4c76-4f50-bf93-51b17aab0cd9/schedule/dayNotes/NOTE_52191d41-ce2d-4295-a477-b75941bd8e0f
61+
```
62+
63+
64+
### Response
65+
The following example shows the response.
66+
67+
``` http
68+
HTTP/1.1 200 OK
69+
Content-Type: application/json
70+
71+
{
72+
"id": "NOTE_52191d41-ce2d-4295-a477-b75941bd8e0f",
73+
"dayNoteDate": "2025-01-08",
74+
"draftDayNote": null,
75+
"sharedDayNote": {
76+
"contentType": "text",
77+
"content": "Expect a lot of customers today with the holiday traffic."
78+
}
79+
}
80+
```
81+

‎api-reference/v1.0/api/daynote-update.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: "Update dayNote"
3+
description: "Update the properties of a dayNote object."
4+
author: lemike
5+
ms.date: 01/17/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: teams
8+
doc_type: apiPageType
9+
---
10+
11+
# Update dayNote
12+
13+
Namespace: microsoft.graph
14+
15+
Update the properties of a [dayNote](../resources/daynote.md) object.
16+
17+
## Permissions
18+
19+
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).
20+
21+
<!-- {
22+
"blockType": "permissions",
23+
"name": "daynote-update-permissions"
24+
}
25+
-->
26+
[!INCLUDE [permissions-table](../includes/permissions/daynote-update-permissions.md)]
27+
28+
## HTTP request
29+
30+
<!-- {
31+
"blockType": "ignored"
32+
}
33+
-->
34+
``` http
35+
PUT /teams/{teamsId}/schedule/dayNotes/{dayNoteId}
36+
```
37+
38+
## Request headers
39+
|Name|Description|
40+
|:---|:---|
41+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
42+
|Content-Type|application/json. Required.|
43+
44+
## Request body
45+
[!INCLUDE [table-intro](../../includes/update-property-table-intro.md)]
46+
47+
|Property|Type|Description|
48+
|:---|:---|:---|
49+
|dayNoteDate|Date|The date for the day note.|
50+
|sharedDayNote|[itemBody](../resources/itembody.md)|The draft version of this **dayNote** that is viewable by managers.|
51+
|draftDayNote|[itemBody](../resources/itembody.md)|The shared version of this **dayNote** that is viewable by both employees and managers.|
52+
53+
54+
## Response
55+
56+
If successful, this method returns a `204 No Content` response code.
57+
58+
## Examples
59+
60+
### Request
61+
62+
The following example shows a request.
63+
64+
``` http
65+
PUT /teams/d72f9b8e-4c76-4f50-bf93-51b17aab0cd9/schedule/dayNotes/NOTE_ff2194ab-0ae5-43e3-acb4-ec2654927213
66+
Content-Type: application/json
67+
68+
{
69+
"dayNoteDate": "2025-01-09",
70+
"sharedDayNote": null,
71+
"draftDayNote": {
72+
"contentType": "text",
73+
"content": "Produce shipment arriving at 2 PM"
74+
}
75+
}
76+
```
77+
78+
79+
### Response
80+
81+
The following example shows the response.
82+
83+
``` http
84+
HTTP/1.1 204 No Content
85+
```
86+

‎api-reference/v1.0/api/schedule-delete-daynotes.md

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: "Delete dayNote"
3+
description: "Delete a dayNote object."
4+
author: lemike
5+
ms.date: 01/17/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: teams
8+
doc_type: apiPageType
9+
---
10+
11+
# Delete dayNote
12+
13+
Namespace: microsoft.graph
14+
15+
Delete a [dayNote](../resources/daynote.md) object.
16+
17+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "schedule-delete-daynotes-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/daynote-delete-permissions.md)]
29+
30+
## HTTP request
31+
32+
<!-- {
33+
"blockType": "ignored"
34+
}
35+
-->
36+
``` http
37+
DELETE /teams/{teamsId}/schedule/dayNotes/{dayNoteId}
38+
```
39+
40+
## Request headers
41+
42+
|Name|Description|
43+
|:---|:---|
44+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
45+
46+
## Request body
47+
48+
Don't supply a request body for this method.
49+
50+
## Response
51+
52+
If successful, this method returns a `204 No Content` response code.
53+
54+
## Examples
55+
56+
### Request
57+
The following example shows a request.
58+
59+
``` http
60+
DELETE /teams/d72f9b8e-4c76-4f50-bf93-51b17aab0cd9/schedule/dayNotes/NOTE_ff2194ab-0ae5-43e3-acb4-ec2654927213
61+
```
62+
63+
### Response
64+
65+
``` http
66+
HTTP/1.1 204 No Content
67+
```
68+

‎api-reference/v1.0/api/schedule-delete-timecards.md

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
title: "Delete timeCard"
3+
description: "Delete a timeCard instance in the schedule."
4+
author: lemike
5+
ms.date: 01/17/2025
6+
ms.localizationpriority: medium
7+
ms.subservice: teams
8+
doc_type: apiPageType
9+
---
10+
11+
# Delete timeCard
12+
13+
Namespace: microsoft.graph
14+
15+
Delete a [timeCard](../resources/timecard.md) instance in a [schedule](../resources/schedule.md).
16+
17+
[!INCLUDE [national-cloud-support](../../includes/global-only.md)]
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "schedule-delete-timecards-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/timecard-delete-permissions.md)]
29+
30+
> [!IMPORTANT]
31+
> When you use the Schedule.ReadWrite.All application permission, you must include the `MS-APP-ACTS-AS` header in the request.
32+
33+
## HTTP request
34+
35+
<!-- {
36+
"blockType": "ignored"
37+
}
38+
-->
39+
``` http
40+
DELETE /teams/{teamsId}/schedule/timeCards/{timeCardId}
41+
```
42+
43+
## Request headers
44+
45+
|Name|Description|
46+
|:---|:---|
47+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
48+
| MS-APP-ACTS-AS | The ID of the user on behalf of whom the app is acting. Required when you use the application permission scope. |
49+
50+
## Request body
51+
Don't supply a request body for this method.
52+
53+
## Response
54+
55+
If successful, this method returns a `204 No Content` response code.
56+
57+
## Example
58+
59+
### Request
60+
The following example shows a request.
61+
62+
<!-- {
63+
"blockType": "request",
64+
"name": "delete_timecard"
65+
}
66+
-->
67+
``` http
68+
DELETE https://graph.microsoft.com/v1.0/teams/{teamsId}/schedule/timeCards/{timeCardId}
69+
```
70+
71+
### Response
72+
73+
The following example shows the response.
74+
75+
<!-- {
76+
"blockType": "response",
77+
"truncated": true
78+
}
79+
-->
80+
``` http
81+
HTTP/1.1 204 No Content
82+
```
83+

0 commit comments

Comments
 (0)