Skip to content

Commit 1162ec1

Browse files
v-sdhakshinav-sdhakshina
committed
minor edits
1 parent 8e6a903 commit 1162ec1

File tree

2 files changed

+110
-111
lines changed

2 files changed

+110
-111
lines changed

‎api-reference/beta/api/chat-post.md

Lines changed: 55 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -361,7 +361,59 @@ Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-982
361361

362362
The async operation is initiated, and the response contains a Location header, which includes a link to the [teamsAsyncOperation](../resources/teamsasyncoperation.md). The link can be used to get the operation status and details. For details, see [Get operation on chat](teamsasyncoperation-get.md#example-get-operation-on-chat).
363363

364-
### Example 4: Create a one-on-one chat using user principal name
364+
### Example 4: Create a one-on-one chat with installed apps which have resource-specific consent (RSC) permissions
365+
366+
#### Request
367+
368+
``` http
369+
POST https://graph.microsoft.com/beta/chats
370+
Content-Type: application/json
371+
372+
{
373+
"chatType": "oneOnOne",
374+
"members": [
375+
{
376+
"@odata.type": "#microsoft.graph.aadUserConversationMember",
377+
"roles": ["owner"],
378+
"user@odata.bind": "https://graph.microsoft.com/beta/users('4b822dfc-2864-44e6-aa1e-7e0e8552168f')"
379+
},
380+
{
381+
"@odata.type": "#microsoft.graph.aadUserConversationMember",
382+
"roles": ["owner"],
383+
"user@odata.bind": "https://graph.microsoft.com/beta/users('6d1e1501-7a3d-45b7-b71b-68d372e5ce14')"
384+
}
385+
],
386+
"installedApps": [
387+
{
388+
"teamsApp@odata.bind": "https://graph.microsoft.com/beta/appCatalogs/teamsApps/8e55a7b1-6766-4f0a-8610-ecacfe3d569a",
389+
"consentedPermissionSet": {
390+
"resourceSpecificPermissions": [
391+
{
392+
"permissionValue": "ChatMessage.Read.Chat",
393+
"permissionType": "application"
394+
},
395+
{
396+
"permissionValue": "OnlineMeeting.ReadBasic.Chat",
397+
"permissionType": "application"
398+
}
399+
]
400+
}
401+
}
402+
]
403+
}
404+
```
405+
406+
#### Response
407+
408+
>**Note:** The response object shown here might be shortened for readability.
409+
410+
```http
411+
HTTP/1.1 202 Accepted
412+
Content-Type: application/json
413+
Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-9828-7875ced51a30@unq.gbl.spaces')/operations('2432b57b-0abd-43db-aa7b-16eadd115d34-861f06db-0208-4815-b67a-965df0d28b7f-10adc8a6-60db-42e2-9761-e56a7e4c7bc9')
414+
```
415+
416+
### Example 5: Create a one-on-one chat using user principal name
365417

366418
#### Request
367419

@@ -465,7 +517,7 @@ Content-Type: application/json
465517
}
466518
```
467519

468-
### Example 5: Create a group chat with in-tenant guest
520+
### Example 6: Create a group chat with in-tenant guest
469521

470522
#### Request
471523

@@ -574,7 +626,7 @@ Content-Type: application/json
574626
}
575627
```
576628

577-
### Example 6: Create a one-on-one chat with a federated user (outside of own organization)
629+
### Example 7: Create a one-on-one chat with a federated user (outside of own organization)
578630

579631
#### Request
580632

@@ -679,58 +731,6 @@ Content-Type: application/json
679731
}
680732
```
681733

682-
### Example 7: Create a one-on-one chat with installed apps which have resource-specific consent (RSC) permissions
683-
684-
#### Request
685-
686-
``` http
687-
POST https://graph.microsoft.com/beta/chats
688-
Content-Type: application/json
689-
690-
{
691-
"chatType": "oneOnOne",
692-
"members": [
693-
{
694-
"@odata.type": "#microsoft.graph.aadUserConversationMember",
695-
"roles": ["owner"],
696-
"user@odata.bind": "https://graph.microsoft.com/beta/users('4b822dfc-2864-44e6-aa1e-7e0e8552168f')"
697-
},
698-
{
699-
"@odata.type": "#microsoft.graph.aadUserConversationMember",
700-
"roles": ["owner"],
701-
"user@odata.bind": "https://graph.microsoft.com/beta/users('6d1e1501-7a3d-45b7-b71b-68d372e5ce14')"
702-
}
703-
],
704-
"installedApps": [
705-
{
706-
"teamsApp@odata.bind": "https://graph.microsoft.com/beta/appCatalogs/teamsApps/8e55a7b1-6766-4f0a-8610-ecacfe3d569a",
707-
"consentedPermissionSet": {
708-
"resourceSpecificPermissions": [
709-
{
710-
"permissionValue": "ChatMessage.Read.Chat",
711-
"permissionType": "application"
712-
},
713-
{
714-
"permissionValue": "OnlineMeeting.ReadBasic.Chat",
715-
"permissionType": "application"
716-
}
717-
]
718-
}
719-
}
720-
]
721-
}
722-
```
723-
724-
#### Response
725-
726-
>**Note:** The response object shown here might be shortened for readability.
727-
728-
```http
729-
HTTP/1.1 202 Accepted
730-
Content-Type: application/json
731-
Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-9828-7875ced51a30@unq.gbl.spaces')/operations('2432b57b-0abd-43db-aa7b-16eadd115d34-861f06db-0208-4815-b67a-965df0d28b7f-10adc8a6-60db-42e2-9761-e56a7e4c7bc9')
732-
```
733-
734734
## Related content
735735

736736
- [Get teamsAsyncOperation](teamsasyncoperation-get.md)

‎api-reference/v1.0/api/chat-post.md

Lines changed: 55 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -284,7 +284,59 @@ Content-Type: application/json
284284
Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-9828-7875ced51a30@unq.gbl.spaces')/operations('2432b57b-0abd-43db-aa7b-16eadd115d34-861f06db-0208-4815-b67a-965df0d28b7f-10adc8a6-60db-42e2-9761-e56a7e4c7bc9')
285285
```
286286

287-
### Example 4: Create a one-on-one chat using user principal name
287+
### Example 4: Create a one-on-one chat with installed apps which have resource-specific consent (RSC) permissions
288+
289+
#### Request
290+
291+
``` http
292+
POST https://graph.microsoft.com/v1.0/chats
293+
Content-Type: application/json
294+
295+
{
296+
"chatType": "oneOnOne",
297+
"members": [
298+
{
299+
"@odata.type": "#microsoft.graph.aadUserConversationMember",
300+
"roles": ["owner"],
301+
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('4b822dfc-2864-44e6-aa1e-7e0e8552168f')"
302+
},
303+
{
304+
"@odata.type": "#microsoft.graph.aadUserConversationMember",
305+
"roles": ["owner"],
306+
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('6d1e1501-7a3d-45b7-b71b-68d372e5ce14')"
307+
}
308+
],
309+
"installedApps": [
310+
{
311+
"teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/8e55a7b1-6766-4f0a-8610-ecacfe3d569a",
312+
"consentedPermissionSet": {
313+
"resourceSpecificPermissions": [
314+
{
315+
"permissionValue": "ChatMessage.Read.Chat",
316+
"permissionType": "application"
317+
},
318+
{
319+
"permissionValue": "OnlineMeeting.ReadBasic.Chat",
320+
"permissionType": "application"
321+
}
322+
]
323+
}
324+
}
325+
]
326+
}
327+
```
328+
329+
#### Response
330+
331+
>**Note:** The response object shown here might be shortened for readability.
332+
333+
```http
334+
HTTP/1.1 202 Accepted
335+
Content-Type: application/json
336+
Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-9828-7875ced51a30@unq.gbl.spaces')/operations('2432b57b-0abd-43db-aa7b-16eadd115d34-861f06db-0208-4815-b67a-965df0d28b7f-10adc8a6-60db-42e2-9761-e56a7e4c7bc9')
337+
```
338+
339+
### Example 5: Create a one-on-one chat using user principal name
288340

289341
#### Request
290342

@@ -372,7 +424,7 @@ Content-Type: application/json
372424
}
373425
```
374426

375-
### Example 5: Create a group chat with tenant guest user
427+
### Example 6: Create a group chat with tenant guest user
376428

377429
#### Request
378430

@@ -466,7 +518,7 @@ Content-Type: application/json
466518
}
467519
```
468520

469-
### Example 6: Create a one-on-one chat with a federated user (outside of own organization)
521+
### Example 7: Create a one-on-one chat with a federated user (outside of own organization)
470522

471523
#### Request
472524

@@ -556,59 +608,6 @@ Content-Type: application/json
556608
}
557609
```
558610

559-
### Example 7: Create a one-on-one chat with installed apps which have resource-specific consent (RSC) permissions
560-
561-
#### Request
562-
563-
``` http
564-
POST https://graph.microsoft.com/v1.0/chats
565-
Content-Type: application/json
566-
567-
{
568-
"chatType": "oneOnOne",
569-
"members": [
570-
{
571-
"@odata.type": "#microsoft.graph.aadUserConversationMember",
572-
"roles": ["owner"],
573-
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('4b822dfc-2864-44e6-aa1e-7e0e8552168f')"
574-
},
575-
{
576-
"@odata.type": "#microsoft.graph.aadUserConversationMember",
577-
"roles": ["owner"],
578-
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('6d1e1501-7a3d-45b7-b71b-68d372e5ce14')"
579-
}
580-
],
581-
"installedApps": [
582-
{
583-
"teamsApp@odata.bind": "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/8e55a7b1-6766-4f0a-8610-ecacfe3d569a",
584-
"consentedPermissionSet": {
585-
"resourceSpecificPermissions": [
586-
{
587-
"permissionValue": "ChatMessage.Read.Chat",
588-
"permissionType": "application"
589-
},
590-
{
591-
"permissionValue": "OnlineMeeting.ReadBasic.Chat",
592-
"permissionType": "application"
593-
}
594-
]
595-
}
596-
}
597-
]
598-
}
599-
```
600-
601-
#### Response
602-
603-
>**Note:** The response object shown here might be shortened for readability.
604-
605-
```http
606-
HTTP/1.1 202 Accepted
607-
Content-Type: application/json
608-
Location: /chats('19:82fe7758-5bb3-4f0d-a43f-e555fd399c6f_bfb5bb25-3a8d-487d-9828-7875ced51a30@unq.gbl.spaces')/operations('2432b57b-0abd-43db-aa7b-16eadd115d34-861f06db-0208-4815-b67a-965df0d28b7f-10adc8a6-60db-42e2-9761-e56a7e4c7bc9')
609-
```
610-
611-
612611
## Related content
613612

614613
[Microsoft Graph service-specific throttling limits](/graph/throttling-limits#microsoft-teams-service-limits)

0 commit comments

Comments
 (0)