Skip to content

Commit 0616df1

Browse files
authored
Merge pull request #25940 from microsoftgraph/main
Merge to publish.
2 parents 63d80ea + ed5efc6 commit 0616df1

File tree

391 files changed

+5401
-689
lines changed

Some content is hidden

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

391 files changed

+5401
-689
lines changed

api-reference/beta/api/aiinteractionhistory-getallenterpriseinteractions.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ The following example shows a request that gets all the Copilot interactions for
6767

6868
The following example shows a request.
6969

70+
# [HTTP](#tab/http)
7071
<!-- {
7172
"blockType": "request",
7273
"name": "aiInteraction_getAllEnterpriseInteractions_1"
@@ -75,6 +76,36 @@ The following example shows a request.
7576
GET https://graph.microsoft.com/beta/copilot/users/9fcefe95-9677-483e-a3c1-22c5d501d737/interactionHistory/getAllEnterpriseInteractions
7677
```
7778

79+
# [C#](#tab/csharp)
80+
[!INCLUDE [sample-code](../includes/snippets/csharp/aiinteraction-getallenterpriseinteractions-1-csharp-snippets.md)]
81+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
82+
83+
# [CLI](#tab/cli)
84+
[!INCLUDE [sample-code](../includes/snippets/cli/aiinteraction-getallenterpriseinteractions-1-cli-snippets.md)]
85+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
86+
87+
# [Go](#tab/go)
88+
[!INCLUDE [sample-code](../includes/snippets/go/aiinteraction-getallenterpriseinteractions-1-go-snippets.md)]
89+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
90+
91+
# [Java](#tab/java)
92+
[!INCLUDE [sample-code](../includes/snippets/java/aiinteraction-getallenterpriseinteractions-1-java-snippets.md)]
93+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
94+
95+
# [JavaScript](#tab/javascript)
96+
[!INCLUDE [sample-code](../includes/snippets/javascript/aiinteraction-getallenterpriseinteractions-1-javascript-snippets.md)]
97+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
98+
99+
# [PHP](#tab/php)
100+
[!INCLUDE [sample-code](../includes/snippets/php/aiinteraction-getallenterpriseinteractions-1-php-snippets.md)]
101+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
102+
103+
# [Python](#tab/python)
104+
[!INCLUDE [sample-code](../includes/snippets/python/aiinteraction-getallenterpriseinteractions-1-python-snippets.md)]
105+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
106+
107+
---
108+
78109
#### Response
79110

80111
The following example shows the response.
@@ -151,6 +182,7 @@ The following example shows a request that gets all the Copilot interactions for
151182

152183
The following example shows a request.
153184

185+
# [HTTP](#tab/http)
154186
<!-- {
155187
"blockType": "request",
156188
"name": "aiInteraction_getAllEnterpriseInteractions_2"
@@ -159,6 +191,36 @@ The following example shows a request.
159191
GET https://graph.microsoft.com/beta/copilot/users/4db02e4b-d144-400e-b194-53253a34c5be/interactionHistory/getAllEnterpriseInteractions?$filter=appClass eq 'IPM.SkypeTeams.Message.Copilot.BizChat'
160192
```
161193

194+
# [C#](#tab/csharp)
195+
[!INCLUDE [sample-code](../includes/snippets/csharp/aiinteraction-getallenterpriseinteractions-2-csharp-snippets.md)]
196+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
197+
198+
# [CLI](#tab/cli)
199+
[!INCLUDE [sample-code](../includes/snippets/cli/aiinteraction-getallenterpriseinteractions-2-cli-snippets.md)]
200+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
201+
202+
# [Go](#tab/go)
203+
[!INCLUDE [sample-code](../includes/snippets/go/aiinteraction-getallenterpriseinteractions-2-go-snippets.md)]
204+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
205+
206+
# [Java](#tab/java)
207+
[!INCLUDE [sample-code](../includes/snippets/java/aiinteraction-getallenterpriseinteractions-2-java-snippets.md)]
208+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
209+
210+
# [JavaScript](#tab/javascript)
211+
[!INCLUDE [sample-code](../includes/snippets/javascript/aiinteraction-getallenterpriseinteractions-2-javascript-snippets.md)]
212+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
213+
214+
# [PHP](#tab/php)
215+
[!INCLUDE [sample-code](../includes/snippets/php/aiinteraction-getallenterpriseinteractions-2-php-snippets.md)]
216+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
217+
218+
# [Python](#tab/python)
219+
[!INCLUDE [sample-code](../includes/snippets/python/aiinteraction-getallenterpriseinteractions-2-python-snippets.md)]
220+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
221+
222+
---
223+
162224
#### Response
163225

164226
The following example shows the response.

api-reference/beta/api/announcement-get.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ If successful, this method returns a `200 OK` response code and an [announcement
5858
### Request
5959

6060
The following example shows a request.
61+
# [HTTP](#tab/http)
6162
<!-- {
6263
"blockType": "request",
6364
"name": "get_announcement"
@@ -67,6 +68,12 @@ The following example shows a request.
6768
GET https://graph.microsoft.com/beta/identity/productChanges/microsoft.graph.announcement/ddde9e3b-7ee4-4066-a62e-fb1fc5fb87a1
6869
```
6970

71+
# [JavaScript](#tab/javascript)
72+
[!INCLUDE [sample-code](../includes/snippets/javascript/get-announcement-javascript-snippets.md)]
73+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
74+
75+
---
76+
7077
### Response
7178

7279
The following example shows the response.

api-reference/beta/api/announcement-list.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@ If successful, this method returns a `200 OK` response code and a collection of
5858
### Request
5959

6060
The following example shows a request.
61+
# [HTTP](#tab/http)
6162
<!-- {
6263
"blockType": "request",
6364
"name": "list_announcement"
@@ -67,6 +68,36 @@ The following example shows a request.
6768
GET https://graph.microsoft.com/beta/identity/productChanges/microsoft.graph.announcement
6869
```
6970

71+
# [C#](#tab/csharp)
72+
[!INCLUDE [sample-code](../includes/snippets/csharp/list-announcement-csharp-snippets.md)]
73+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
74+
75+
# [CLI](#tab/cli)
76+
[!INCLUDE [sample-code](../includes/snippets/cli/list-announcement-cli-snippets.md)]
77+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
78+
79+
# [Go](#tab/go)
80+
[!INCLUDE [sample-code](../includes/snippets/go/list-announcement-go-snippets.md)]
81+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
82+
83+
# [Java](#tab/java)
84+
[!INCLUDE [sample-code](../includes/snippets/java/list-announcement-java-snippets.md)]
85+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
86+
87+
# [JavaScript](#tab/javascript)
88+
[!INCLUDE [sample-code](../includes/snippets/javascript/list-announcement-javascript-snippets.md)]
89+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
90+
91+
# [PHP](#tab/php)
92+
[!INCLUDE [sample-code](../includes/snippets/php/list-announcement-php-snippets.md)]
93+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
94+
95+
# [Python](#tab/python)
96+
[!INCLUDE [sample-code](../includes/snippets/python/list-announcement-python-snippets.md)]
97+
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
98+
99+
---
100+
70101
### Response
71102

72103
The following example shows the response.

api-reference/beta/api/authentication-delete-hardwareoathmethods.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
3737
-->
3838
[!INCLUDE [permissions-table](../includes/permissions/authentication-delete-hardwareoathmethods-2-permissions.md)]
3939

40+
[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
41+
4042
## HTTP request
4143

4244
Unassign yourself a hardware OATH authentication method.
@@ -116,7 +118,6 @@ DELETE https://graph.microsoft.com/beta/me/authentication/hardwareOathMethods/{h
116118

117119
---
118120

119-
120121
### Response
121122

122123
The following example shows the response.

api-reference/beta/api/authentication-list-hardwareoathmethods.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2828
<!-- { "blockType": "permissions", "name": "authentication_list_hardwareoathmethods_2" } -->
2929
[!INCLUDE [permissions-table](../includes/permissions/authentication-list-hardwareoathmethods-2-permissions.md)]
3030

31+
[!INCLUDE [rbac-authentication-methods-apis-read-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-read-others.md)]
32+
3133
## HTTP request
3234
Get details of your own hardware OATH methods.
3335
<!-- {
@@ -110,7 +112,6 @@ GET https://graph.microsoft.com/beta/me/authentication/hardwareOathMethods
110112

111113
---
112114

113-
114115
### Response
115116

116117
The following example shows the response.

api-reference/beta/api/authentication-post-hardwareoathmethods.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
3232
-->
3333
[!INCLUDE [permissions-table](../includes/permissions/authentication-post-hardwareoathmethods-2-permissions.md)]
3434

35+
[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]
36+
3537
## HTTP request
3638
Assign a hardware OATH authentication method to yourself.
3739
<!-- {
@@ -124,7 +126,6 @@ Content-Type: application/json
124126

125127
---
126128

127-
128129
### Response
129130

130131
The following example shows the response.

api-reference/beta/api/authenticationmethoddevice-delete-hardwareoathdevices.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2727
-->
2828
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-delete-hardwareoathdevices-permissions.md)]
2929

30+
[!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]
31+
3032
## HTTP request
3133

3234
<!-- {
@@ -96,7 +98,6 @@ DELETE https://graph.microsoft.com/beta/directory/authenticationMethodDevices/ha
9698

9799
---
98100

99-
100101
### Response
101102

102103
The following example shows the response.

api-reference/beta/api/authenticationmethoddevice-list-hardwareoathdevices.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2727
-->
2828
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-list-hardwareoathdevices-permissions.md)]
2929

30+
[!INCLUDE [rbac-authentication-methods-policy-apis-read](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-read.md)]
31+
3032
## HTTP request
3133

3234
<!-- {

api-reference/beta/api/authenticationmethoddevice-post-hardwareoathdevices.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2727
-->
2828
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-post-hardwareoathdevices-permissions.md)]
2929

30+
[!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]
31+
3032
## HTTP request
3133

3234
<!-- {

api-reference/beta/api/authenticationmethoddevice-update.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
2727
-->
2828
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-post-hardwareoathdevices-permissions.md)]
2929

30+
[!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]
31+
3032
## HTTP request
3133

3234
<!-- {
@@ -133,7 +135,6 @@ Content-Type: application/json
133135

134136
---
135137

136-
137138
### Response
138139

139140
The following example shows the response.
Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
---
2+
title: "call: startRecording"
3+
ms.date: 11/15/2024
4+
description: "Start the recording of a call."
5+
author: "calvintang"
6+
ms.localizationpriority: medium
7+
ms.subservice: "cloud-communications"
8+
doc_type: apiPageType
9+
---
10+
11+
# call: startRecording
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Start the recording of a call.
18+
19+
[!INCLUDE [national-cloud-support](../../includes/global-us.md)]
20+
21+
## Permissions
22+
23+
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).
24+
25+
<!-- { "blockType": "permissions", "name": "call_startrecording" } -->
26+
[!INCLUDE [permissions-table](../includes/permissions/call-startrecording-permissions.md)]
27+
28+
## HTTP request
29+
<!-- { "blockType": "ignored" } -->
30+
31+
```http
32+
POST /communications/calls/{id}/microsoft.graph.StartRecording
33+
```
34+
35+
## Request headers
36+
37+
| Name | Description |
38+
|:--------------|:--------------------------|
39+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
40+
| Content-type | application/json. Required. |
41+
42+
## Request body
43+
44+
Don't supply a request body for this method.
45+
46+
## Response
47+
48+
This method returns a `202 Accepted` response code and a [startRecordingOperation](../resources/startrecordingoperation.md) object created for this request.
49+
50+
## Example
51+
52+
The following example shows how to call this API.
53+
54+
### Request
55+
56+
The following example shows the request.
57+
58+
<!-- {
59+
"blockType": "request",
60+
"name": "call-startRecording"
61+
}-->
62+
63+
```http
64+
POST https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/microsoft.graph.StartRecording
65+
```
66+
67+
---
68+
69+
### Response
70+
71+
The following example shows the response.
72+
73+
> **Note:** The response object shown here might be shortened for readability.
74+
75+
<!-- {
76+
"blockType": "response",
77+
"name": "call-startRecording",
78+
"truncated": true,
79+
"@odata.type": "microsoft.graph.startRecordingOperation"
80+
} -->
81+
82+
```http
83+
HTTP/1.1 202 Accepted
84+
Location: https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/operations/2d7ab59c-f8bd-4911-8302-6d58ab60e338
85+
86+
{
87+
"@odata.type": "#microsoft.graph.startRecordingOperation",
88+
"clientContext": "clientContext-value",
89+
"status": "running"
90+
}
91+
92+
```
93+
94+
<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
95+
2024-11-12 14:57:30 UTC -->
96+
<!--
97+
{
98+
"type": "#page.annotation",
99+
"description": "call: startRecording",
100+
"keywords": "",
101+
"section": "documentation",
102+
"tocPath": "",
103+
"suppressions": [
104+
]
105+
}
106+
-->

0 commit comments

Comments
 (0)