Skip to content

Commit 70c03da

Browse files
author
jsinghmokha
committed
Standardize If-Match header documentation across all section APIs
- All write operations now reference @microsoft.graph.sectionsVersion from list sections response as the If-Match value - If-None-Match in get section also references sectionsVersion - Fix ETag format: use strongly-quoted unix timestamp ("1742515200") instead of weak ETag (W/"123456") - Consistent across all 8 section management API topics
1 parent 1636e46 commit 70c03da

8 files changed

Lines changed: 24 additions & 24 deletions

‎api-reference/beta/api/teamworksection-delete.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ DELETE /users/{user-id}/teamwork/sections/{teamworkSection-id}
3737
| Header | Value |
3838
|:-------|:------|
3939
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
40-
| If-Match | The ETag value of a previously retrieved **teamworkSection**. Required for optimistic concurrency control. |
40+
| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
4141

4242
## Request body
4343

@@ -60,7 +60,7 @@ The following example shows a request.
6060
}-->
6161
```http
6262
DELETE https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890
63-
If-Match: W/"123456"
63+
If-Match: "1742515200"
6464
```
6565

6666
### Response

‎api-reference/beta/api/teamworksection-get.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ This method doesn't support [OData query parameters](/graph/query-parameters) to
4141
| Header | Value |
4242
|:-------|:------|
4343
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
44-
| If-None-Match | The ETag value of a previously retrieved **teamworkSection**. If the resource didn't change, this header causes a `304 Not Modified` response. Optional. |
44+
| If-None-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). If the section hierarchy didn't change, this header causes a `304 Not Modified` response. Optional. |
4545

4646
## Request body
4747

@@ -80,11 +80,11 @@ The following example shows the response.
8080
```http
8181
HTTP/1.1 200 OK
8282
Content-type: application/json
83-
ETag: W/"123456"
83+
ETag: "1742515200"
8484
8585
{
8686
"@odata.type": "#microsoft.graph.teamworkSection",
87-
"@odata.etag": "W/\"123456\"",
87+
"@odata.etag": "\"1742515200\"",
8888
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
8989
"displayName": "Favorites",
9090
"displayIcon": {

‎api-reference/beta/api/teamworksection-post-items.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items
3838
|:-------|:------|
3939
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
4040
| Content-Type | application/json. Required. |
41-
| If-Match | The ETag value of a previously retrieved **teamworkSectionItem**. Required for optimistic concurrency control. |
41+
| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
4242

4343
## Request body
4444

@@ -78,7 +78,7 @@ The following example shows a request to add a chat to a section.
7878
```http
7979
POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
8080
Content-type: application/json
81-
If-Match: W/"123456"
81+
If-Match: "1742515200"
8282
8383
{
8484
"id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2"
@@ -103,7 +103,7 @@ Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8
103103
104104
{
105105
"@odata.type": "#microsoft.graph.teamworkSectionItem",
106-
"@odata.etag": "W/\"123457\"",
106+
"@odata.etag": "\"1742515210\"",
107107
"id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
108108
"itemType": "chat",
109109
"createdDateTime": "2026-03-08T10:00:00Z",

‎api-reference/beta/api/teamworksection-update.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ PATCH /users/{user-id}/teamwork/sections/{teamworkSection-id}
3838
|:-------|:------|
3939
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
4040
| Content-Type | application/json. Required. |
41-
| If-Match | The ETag value of a previously retrieved **teamworkSection**. Required for optimistic concurrency control. |
41+
| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
4242

4343
## Request body
4444

@@ -79,7 +79,7 @@ The following example shows a request.
7979
```http
8080
PATCH https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890
8181
Content-type: application/json
82-
If-Match: W/"123456"
82+
If-Match: "1742515200"
8383
8484
{
8585
"displayName": "Important Conversations"
@@ -103,7 +103,7 @@ Content-type: application/json
103103
104104
{
105105
"@odata.type": "#microsoft.graph.teamworkSection",
106-
"@odata.etag": "W/\"123457\"",
106+
"@odata.etag": "\"1742515210\"",
107107
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
108108
"displayName": "Important Conversations",
109109
"displayIcon": {
@@ -135,7 +135,7 @@ The following example shows a request.
135135
```http
136136
PATCH https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890
137137
Content-type: application/json
138-
If-Match: W/"123457"
138+
If-Match: "1742515210"
139139
140140
{
141141
"sortType": "unreadThenMostRecent"
@@ -159,7 +159,7 @@ Content-type: application/json
159159
160160
{
161161
"@odata.type": "#microsoft.graph.teamworkSection",
162-
"@odata.etag": "W/\"123458\"",
162+
"@odata.etag": "\"1742515220\"",
163163
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
164164
"displayName": "Important Conversations",
165165
"displayIcon": {

‎api-reference/beta/api/teamworksectionitem-delete.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ DELETE /users/{user-id}/teamwork/sections/{teamworkSection-id}/items/{teamworkSe
3737
| Header | Value |
3838
|:-------|:------|
3939
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
40-
| If-Match | The ETag value of a previously retrieved **teamworkSectionItem**. Required for optimistic concurrency control. |
40+
| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
4141

4242
## Request body
4343

@@ -60,7 +60,7 @@ The following example shows a request.
6060
}-->
6161
```http
6262
DELETE https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2
63-
If-Match: W/"123456"
63+
If-Match: "1742515200"
6464
```
6565

6666
### Response

‎api-reference/beta/api/teamworksectionitem-move.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items/{teamworkSect
3838
|:-------|:------|
3939
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
4040
| Content-Type | application/json. Required. |
41-
| If-Match | The ETag value of a previously retrieved **teamworkSectionItem**. Required for optimistic concurrency control. |
41+
| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
4242

4343
## Request body
4444

@@ -68,7 +68,7 @@ The following example shows a request to move a chat from the "Favorites" sectio
6868
```http
6969
POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2/move
7070
Content-type: application/json
71-
If-Match: W/"123456"
71+
If-Match: "1742515200"
7272
7373
{
7474
"targetSectionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
@@ -92,7 +92,7 @@ Content-type: application/json
9292
9393
{
9494
"@odata.type": "#microsoft.graph.teamworkSectionItem",
95-
"@odata.etag": "W/\"123457\"",
95+
"@odata.etag": "\"1742515210\"",
9696
"id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
9797
"itemType": "chat",
9898
"createdDateTime": "2026-03-08T10:30:00Z",

‎api-reference/beta/api/userteamwork-list-sections.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -92,11 +92,11 @@ Content-type: application/json
9292
"a1b2c3d4-e5f6-7890-abcd-ef1234567890",
9393
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
9494
],
95-
"@microsoft.graph.sectionsVersion": "123456",
95+
"@microsoft.graph.sectionsVersion": "1742515200",
9696
"value": [
9797
{
9898
"@odata.type": "#microsoft.graph.teamworkSection",
99-
"@odata.etag": "W/\"123456\"",
99+
"@odata.etag": "\"1742515200\"",
100100
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
101101
"displayName": "Favorites",
102102
"displayIcon": {
@@ -114,7 +114,7 @@ Content-type: application/json
114114
},
115115
{
116116
"@odata.type": "#microsoft.graph.teamworkSection",
117-
"@odata.etag": "W/\"123457\"",
117+
"@odata.etag": "\"1742515200\"",
118118
"id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
119119
"displayName": "Teams and Channels",
120120
"displayIcon": null,

‎api-reference/beta/api/userteamwork-post-sections.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ POST /users/{user-id}/teamwork/sections
3838
|:-------|:------|
3939
| Authorization | Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts). |
4040
| Content-Type | application/json. Required. |
41-
| If-Match | The ETag value of a previously retrieved **userTeamwork** resource. Required for optimistic concurrency control. |
41+
| If-Match | The value of the **@microsoft.graph.sectionsVersion** property previously retrieved from [listing sections](userteamwork-list-sections.md). Required for optimistic concurrency control. |
4242

4343
## Request body
4444

@@ -71,7 +71,7 @@ The following example shows a request.
7171
```http
7272
POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections
7373
Content-type: application/json
74-
If-Match: W/"123456"
74+
If-Match: "1742515200"
7575
7676
{
7777
"displayName": "Project Alpha",
@@ -101,7 +101,7 @@ Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8
101101
102102
{
103103
"@odata.type": "#microsoft.graph.teamworkSection",
104-
"@odata.etag": "W/\"123457\"",
104+
"@odata.etag": "\"1742515210\"",
105105
"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
106106
"displayName": "Project Alpha",
107107
"displayIcon": {

0 commit comments

Comments
 (0)