Skip to content

Commit cc30f1d

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
Learn Build Service GitHub App
authored and
Learn Build Service GitHub App
committed
Merging changes synced from https://github.com/microsoftgraph/microsoft-graph-docs (branch live)
2 parents ed2ecde + d978974 commit cc30f1d

17 files changed

+556
-103
lines changed

‎api-reference/beta/api/identitygovernance-lifecycleworkflowscontainer-list-taskdefinitions.md

Lines changed: 78 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -228,6 +228,16 @@ Content-Type: application/json
228228
"name": "locale",
229229
"values": [],
230230
"valueType": "string"
231+
},
232+
{
233+
"name": "to",
234+
"values": [
235+
"User",
236+
"Manager",
237+
"Sponsors",
238+
"{UserId}"
239+
],
240+
"valueType": "string"
231241
}
232242
]
233243
},
@@ -257,6 +267,16 @@ Content-Type: application/json
257267
"name": "locale",
258268
"values": [],
259269
"valueType": "string"
270+
},
271+
{
272+
"name": "to",
273+
"values": [
274+
"User",
275+
"Manager",
276+
"Sponsors",
277+
"{UserId}"
278+
],
279+
"valueType": "string"
260280
}
261281
]
262282
},
@@ -345,8 +365,8 @@ Content-Type: application/json
345365
},
346366
{
347367
"category": "leaver",
348-
"description": "Send offboarding email to user's manager before the last day of work",
349-
"displayName": "Send email before user's last day",
368+
"description": "Send offboarding email to user’s manager before the last day of work",
369+
"displayName": "Send email before user’s last day",
350370
"id": "52853a3e-f4e5-4eb8-bb24-1ac09a1da935",
351371
"version": 1,
352372
"parameters": [
@@ -369,13 +389,23 @@ Content-Type: application/json
369389
"name": "locale",
370390
"values": [],
371391
"valueType": "string"
392+
},
393+
{
394+
"name": "to",
395+
"values": [
396+
"User",
397+
"Manager",
398+
"Sponsors",
399+
"{UserId}"
400+
],
401+
"valueType": "string"
372402
}
373403
]
374404
},
375405
{
376406
"category": "leaver",
377-
"description": "Send offboarding email to user's manager on the last day of work",
378-
"displayName": "Send email on user's last day",
407+
"description": "Send offboarding email to user’s manager on the last day of work",
408+
"displayName": "Send email on user’s last day",
379409
"id": "9c0a1eaf-5bda-4392-9d9e-6e155bb57411",
380410
"version": 1,
381411
"parameters": [
@@ -398,13 +428,23 @@ Content-Type: application/json
398428
"name": "locale",
399429
"values": [],
400430
"valueType": "string"
431+
},
432+
{
433+
"name": "to",
434+
"values": [
435+
"User",
436+
"Manager",
437+
"Sponsors",
438+
"{UserId}"
439+
],
440+
"valueType": "string"
401441
}
402442
]
403443
},
404444
{
405445
"category": "leaver",
406-
"description": "Send offboarding email to user's manager after the last day of work",
407-
"displayName": "Send email after user's last day",
446+
"description": "Send offboarding email to user’s manager after the last day of work",
447+
"displayName": "Send email after user’s last day",
408448
"id": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce",
409449
"version": 1,
410450
"parameters": [
@@ -427,12 +467,22 @@ Content-Type: application/json
427467
"name": "locale",
428468
"values": [],
429469
"valueType": "string"
470+
},
471+
{
472+
"name": "to",
473+
"values": [
474+
"User",
475+
"Manager",
476+
"Sponsors",
477+
"{UserId}"
478+
],
479+
"valueType": "string"
430480
}
431481
]
432482
},
433483
{
434484
"category": "joiner",
435-
"description": "Send onboarding reminder email to user's manager",
485+
"description": "Send onboarding reminder email to user’s manager",
436486
"displayName": "Send onboarding reminder email",
437487
"id": "3C860712-2D37-42A4-928F-5C93935D26A1",
438488
"version": 1,
@@ -456,6 +506,16 @@ Content-Type: application/json
456506
"name": "locale",
457507
"values": [],
458508
"valueType": "string"
509+
},
510+
{
511+
"name": "to",
512+
"values": [
513+
"User",
514+
"Manager",
515+
"Sponsors",
516+
"{UserId}"
517+
],
518+
"valueType": "string"
459519
}
460520
]
461521
},
@@ -510,7 +570,7 @@ Content-Type: application/json
510570
},
511571
{
512572
"category": "mover",
513-
"description": "Send email to notify user's manager of user move",
573+
"description": "Send email to notify user’s manager of user move",
514574
"displayName": "Send email to notify manager of user move",
515575
"id": "aab41899-9972-422a-9d97-f626014578b7",
516576
"version": 1,
@@ -534,6 +594,16 @@ Content-Type: application/json
534594
"name": "locale",
535595
"values": [],
536596
"valueType": "string"
597+
},
598+
{
599+
"name": "to",
600+
"values": [
601+
"User",
602+
"Manager",
603+
"Sponsors",
604+
"{UserId}"
605+
],
606+
"valueType": "string"
537607
}
538608
]
539609
},

‎api-reference/beta/api/industrydata-onerosterapidataconnector-update.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ PATCH /external/industryData/dataConnectors/{industryDataConnectorId}
5050
|:---|:---|:---|
5151
| displayName | String | The name of the data connector. Inherited from [industryDataConnector](../resources/industrydata-industrydataconnector.md). Required. |
5252
| apiFormat | microsoft.graph.industryData.apiFormat | The API format of the external system being connected to. Inherited from [apiDataConnector](../resources/industrydata-apidataconnector.md). The possible values are: `oneRoster`, `unknownFutureValue`. Required. |
53-
| baseUrl | String | The base URI including the scheme, host, and path for the API (with or without a trailing '/'). Example: https://example.com/ims/oneRoster/v1p1. Inherited from [apiDataConnector](../resources/industrydata-apidataconnector.md). Required.|
53+
| baseUrl | String | The base URI including the scheme, host, and path for the API (with or without a trailing '/'). Example: `https://example.com/ims/oneRoster/v1p1`. Inherited from [apiDataConnector](../resources/industrydata-apidataconnector.md). Required.|
5454
| credential | [microsoft.graph.industryData.credential](../resources/industrydata-credential.md) | The base type for all supported credentials. Inherited from [apiDataConnector](../resources/industrydata-apidataconnector.md). Required. |
5555
| apiVersion | String | The API version of the OneRoster source. Required. |
5656
| isDemographicsEnabled | Boolean | Indicates whether the user specified to import optional demographics data. Required. |

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

Lines changed: 52 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -28,19 +28,20 @@ Depending on the resource you're deleting the extension from and the permission
2828

2929
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
3030
|:-----|:-----|:-----|:-----|
31-
| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
32-
| [baseTasklist](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
33-
| [device](../resources/device.md) | Directory.AccessAsUser.All | Not supported | Device.ReadWrite.All |
31+
| [device](../resources/device.md) | Directory.AccessAsUser.All | Not supported. | Device.ReadWrite.All |
32+
| [driveItem](../resources/driveitem.md) | Files.ReadWrite | Files.ReadWrite | Not supported. |
3433
| [event](../resources/event.md) | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
35-
| [group](../resources/group.md) | Group.ReadWrite.All | Not supported | Group.ReadWrite.All |
36-
| [group event](../resources/event.md) | Group.ReadWrite.All | Not supported | Not supported |
37-
| [group post](../resources/post.md) | Group.ReadWrite.All | Not supported | Group.ReadWrite.All |
34+
| [group](../resources/group.md) | Group.ReadWrite.All | Not supported. | Group.ReadWrite.All |
35+
| [group event](../resources/event.md) | Group.ReadWrite.All | Not supported. | Not supported |
36+
| [group post](../resources/post.md) | Group.ReadWrite.All | Not supported. | Group.ReadWrite.All |
3837
| [message](../resources/message.md) | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
39-
| [organization](../resources/organization.md) | Organization.ReadWrite.All | Not supported | Organization.ReadWrite.All |
38+
| [organization](../resources/organization.md) | Organization.ReadWrite.All | Not supported. | Organization.ReadWrite.All |
4039
| [personal contact](../resources/contact.md) | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
4140
| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
4241
| [todoTasklist](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
43-
| [user](../resources/user.md) | User.ReadWrite | Not supported | User.ReadWrite.All |
42+
| [user](../resources/user.md) | User.ReadWrite | Not supported. | User.ReadWrite.All |
43+
| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
44+
| [baseTasklist](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
4445

4546
## HTTP request
4647

@@ -63,6 +64,7 @@ DELETE /users/me/todo/lists/{listId}/extensions/{extensionId}
6364
DELETE /users/me/todo/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
6465
DELETE /users/me/tasks/lists/{listId}/extensions/{extensionId}
6566
DELETE /users/me/tasks/lists/{listId}/tasks/{taskId}/extensions/{extensionId}
67+
DELETE /drive/items/{itemId}/extensions/{extensionId}
6668
```
6769

6870
>**Note:** The above syntax shows some common ways to identify a resource instance, in order to delete an extension from it.
@@ -81,7 +83,8 @@ Don't supply a request body for this method.
8183
If successful, this method returns `204 No Content` response code. It doesn't return anything in the response body.
8284

8385
## Example
84-
### Request
86+
87+
### Request 1
8588
The first example references an extension by its name and deletes the extension in the specified message.
8689

8790
# [HTTP](#tab/http)
@@ -128,14 +131,53 @@ DELETE https://graph.microsoft.com/beta/me/messages/AAMkAGE1M2IyNGNmLTI5MTktNDUy
128131

129132
---
130133

134+
### Response 1
135+
The following example shows the response.
136+
<!-- {
137+
"blockType": "response",
138+
"truncated": false
139+
} -->
140+
```http
141+
HTTP/1.1 204 No Content
142+
```
143+
144+
****
145+
146+
### Request 2
147+
131148
The second example deletes an extension in the specified group event.
132149

133150
<!-- { "blockType": "ignored" } -->
134151
```http
135152
DELETE https://graph.microsoft.com/beta/groups/f5480dfd-7d77-4d0b-ba2e-3391953cc74a/events/AAMkADVlN17IsAAA=/extensions/Com.Contoso.Referral
136153
```
137154

138-
### Response
155+
### Response 2
156+
The following example shows the response.
157+
<!-- {
158+
"blockType": "response",
159+
"truncated": false
160+
} -->
161+
```http
162+
HTTP/1.1 204 No Content
163+
```
164+
165+
****
166+
167+
### Request 3
168+
169+
The following example shows how to delete an extension by its name from the specified **driveItem**.
170+
171+
<!-- {
172+
"blockType": "request",
173+
"name": "delete_opentypeextension_3",
174+
"sampleKeys": ["01FWCEC553UUOHTOAGBVE2IXBQTIZY3JZQ", "Com.Contoso.Referral"]
175+
}-->
176+
```http
177+
DELETE https://graph.microsoft.com/beta/drive/items/01FWCEC553UUOHTOAGBVE2IXBQTIZY3JZQ/extensions/Com.Contoso.Referral
178+
```
179+
180+
### Response 3
139181
The following example shows the response.
140182
<!-- {
141183
"blockType": "response",

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

Lines changed: 56 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -36,19 +36,20 @@ Depending on the resource that contains the extension and the permission type (d
3636

3737
| Supported resource | Delegated (work or school account) | Delegated (personal Microsoft account) | Application |
3838
|:-----|:-----|:-----|:-----|
39-
| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
40-
| [baseTaskList](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
41-
| [device](../resources/device.md) | Directory.Read.All | Not supported | Device.ReadWrite.All |
39+
| [device](../resources/device.md) | Directory.Read.All | Not supported. | Device.ReadWrite.All |
40+
| [driveItem](../resources/driveitem.md) | Files.Read | Files.Read | Not supported. |
4241
| [event](../resources/event.md) | Calendars.Read | Calendars.Read | Calendars.Read |
43-
| [group](../resources/group.md) | Group.Read.All | Not supported | Group.Read.All |
44-
| [group event](../resources/event.md) | Group.Read.All | Not supported | Not supported |
45-
| [group post](../resources/post.md) | Group.Read.All | Not supported | Group.Read.All |
42+
| [group](../resources/group.md) | Group.Read.All | Not supported. | Group.Read.All |
43+
| [group event](../resources/event.md) | Group.Read.All | Not supported. | Not supported. |
44+
| [group post](../resources/post.md) | Group.Read.All | Not supported. | Group.Read.All |
4645
| [message](../resources/message.md) | Mail.Read | Mail.Read | Mail.Read |
47-
| [organization](../resources/organization.md) | User.Read | Not supported | Organization.Read.All |
46+
| [organization](../resources/organization.md) | User.Read | Not supported. | Organization.Read.All |
4847
| [personal contact](../resources/contact.md) | Contacts.Read | Contacts.Read | Contacts.Read |
49-
| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
50-
| [todoTaskList](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported |
51-
| [user](../resources/user.md) | User.Read | Not supported | User.Read.All |
48+
| [todoTask](../resources/todotask.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. |
49+
| [todoTaskList](../resources/todotasklist.md) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. |
50+
| [user](../resources/user.md) | User.Read | Not supported. | User.Read.All |
51+
| [baseTask](../resources/basetask.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. |
52+
| [baseTaskList](../resources/basetasklist.md) (deprecated) | Tasks.ReadWrite | Tasks.ReadWrite | Not supported. |
5253

5354
## HTTP request
5455

@@ -75,6 +76,7 @@ GET /users/{userId|userPrincipalName}/todo/lists/{listId}/tasks/{todoTaskId}/ext
7576
GET /users/{userId|userPrincipalName}/todo/lists/{listId}/extensions/{extensionId}
7677
GET /users/{userId|userPrincipalName}/tasks/lists/{listId}/tasks/{baseTaskId}/extensions/{extensionId}
7778
GET /users/{userId|userPrincipalName}/tasks/lists/{listId}/extensions/{extensionId}
79+
GET /drive/items/{itemId}/extensions/{extensionId}
7880
```
7981

8082
### Get a known resource instance expanded with a matching extension
@@ -94,6 +96,7 @@ GET /users/{userId|userPrincipalName}/todo/lists/{listId}/tasks/{taskId}?$expand
9496
GET /users/{userId|userPrincipalName}/todo/lists/{listId}?$expand=extensions($filter=id eq '{extensionId}')
9597
GET /users/{userId|userPrincipalName}/tasks/lists/{listId}/tasks/{taskId}?$expand=extensions($filter=id eq '{extensionId}')
9698
GET /users/{userId|userPrincipalName}/tasks/lists/{listId}?$expand=extensions($filter=id eq '{extensionId}')
99+
GET /drive/items/{itemID}?$expand=extensions($filter=id eq 'extensionId')
97100
```
98101

99102

@@ -538,8 +541,6 @@ The fifth example looks at all messages in the signed-in user's mailbox to find
538541
expands them by including the extension. The filter returns extensions that has the **id** property matching the extension name
539542
`Com.Contoso.Referral`.
540543

541-
542-
543544
# [HTTP](#tab/http)
544545
<!-- {
545546
"blockType": "request",
@@ -675,6 +676,49 @@ HTTP/1.1 200 OK
675676
676677
```
677678

679+
****
680+
681+
#### Request 6
682+
683+
The following example shows how to get a **driveItem** and expand its extensions using a filter. The filter returns the extension with an ID that matches a fully qualified name.
684+
685+
<!-- {
686+
"blockType": "request",
687+
"name": "get_opentypeextension_6",
688+
"sampleKeys": ["01FWCEC553UUOHTOAGBVE2IXBQTIZY3JZQ"]
689+
}-->
690+
```http
691+
GET https://graph.microsoft.com/drive/items/01FWCEC553UUOHTOAGBVE2IXBQTIZY3JZQ?$expand=extensions($filter=id eq 'myCustomExtension')
692+
```
693+
694+
#### Response 6
695+
696+
The following example shows the response.
697+
<!-- {
698+
"blockType": "response",
699+
"truncated": true,
700+
"@odata.type": "microsoft.graph.openTypeExtension"
701+
} -->
702+
703+
```http
704+
HTTP/1.1 200 OK
705+
Content-type: application/json
706+
707+
{
708+
"@odata.context": "https://graph.microsoft.com/beta/drive/items",
709+
"name": "New Folder",
710+
"folder": {},
711+
"@microsoft.graph.conflictBehavior": "rename",
712+
"extensions": [
713+
{
714+
"id": "myCustomExtension",
715+
"extensionName": "myCustomExtension",
716+
"myCustomString": "Contoso data",
717+
"myCustomBool": false
718+
}
719+
]
720+
}
721+
```
678722

679723

680724
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
@@ -690,5 +734,3 @@ HTTP/1.1 200 OK
690734
]
691735
}
692736
-->
693-
694-

0 commit comments

Comments
 (0)