Skip to content

Commit

Permalink
Merge pull request #25940 from microsoftgraph/main
Browse files Browse the repository at this point in the history
Merge to publish.
  • Loading branch information
Lauragra authored Dec 17, 2024
2 parents 63d80ea + ed5efc6 commit 0616df1
Show file tree
Hide file tree
Showing 391 changed files with 5,401 additions and 689 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,7 @@ The following example shows a request that gets all the Copilot interactions for

The following example shows a request.

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

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/aiinteraction-getallenterpriseinteractions-1-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [CLI](#tab/cli)
[!INCLUDE [sample-code](../includes/snippets/cli/aiinteraction-getallenterpriseinteractions-1-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/aiinteraction-getallenterpriseinteractions-1-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/aiinteraction-getallenterpriseinteractions-1-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/aiinteraction-getallenterpriseinteractions-1-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [PHP](#tab/php)
[!INCLUDE [sample-code](../includes/snippets/php/aiinteraction-getallenterpriseinteractions-1-php-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Python](#tab/python)
[!INCLUDE [sample-code](../includes/snippets/python/aiinteraction-getallenterpriseinteractions-1-python-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

#### Response

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

The following example shows a request.

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

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/aiinteraction-getallenterpriseinteractions-2-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [CLI](#tab/cli)
[!INCLUDE [sample-code](../includes/snippets/cli/aiinteraction-getallenterpriseinteractions-2-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/aiinteraction-getallenterpriseinteractions-2-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/aiinteraction-getallenterpriseinteractions-2-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/aiinteraction-getallenterpriseinteractions-2-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [PHP](#tab/php)
[!INCLUDE [sample-code](../includes/snippets/php/aiinteraction-getallenterpriseinteractions-2-php-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Python](#tab/python)
[!INCLUDE [sample-code](../includes/snippets/python/aiinteraction-getallenterpriseinteractions-2-python-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

#### Response

The following example shows the response.
Expand Down
7 changes: 7 additions & 0 deletions api-reference/beta/api/announcement-get.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ If successful, this method returns a `200 OK` response code and an [announcement
### Request

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

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/get-announcement-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

### Response

The following example shows the response.
Expand Down
31 changes: 31 additions & 0 deletions api-reference/beta/api/announcement-list.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ If successful, this method returns a `200 OK` response code and a collection of
### Request

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

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/list-announcement-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [CLI](#tab/cli)
[!INCLUDE [sample-code](../includes/snippets/cli/list-announcement-cli-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Go](#tab/go)
[!INCLUDE [sample-code](../includes/snippets/go/list-announcement-go-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Java](#tab/java)
[!INCLUDE [sample-code](../includes/snippets/java/list-announcement-java-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [JavaScript](#tab/javascript)
[!INCLUDE [sample-code](../includes/snippets/javascript/list-announcement-javascript-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [PHP](#tab/php)
[!INCLUDE [sample-code](../includes/snippets/php/list-announcement-php-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

# [Python](#tab/python)
[!INCLUDE [sample-code](../includes/snippets/python/list-announcement-python-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]

---

### Response

The following example shows the response.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
-->
[!INCLUDE [permissions-table](../includes/permissions/authentication-delete-hardwareoathmethods-2-permissions.md)]

[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]

## HTTP request

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

---


### Response

The following example shows the response.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
<!-- { "blockType": "permissions", "name": "authentication_list_hardwareoathmethods_2" } -->
[!INCLUDE [permissions-table](../includes/permissions/authentication-list-hardwareoathmethods-2-permissions.md)]

[!INCLUDE [rbac-authentication-methods-apis-read-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-read-others.md)]

## HTTP request
Get details of your own hardware OATH methods.
<!-- {
Expand Down Expand Up @@ -110,7 +112,6 @@ GET https://graph.microsoft.com/beta/me/authentication/hardwareOathMethods

---


### Response

The following example shows the response.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
-->
[!INCLUDE [permissions-table](../includes/permissions/authentication-post-hardwareoathmethods-2-permissions.md)]

[!INCLUDE [rbac-authentication-methods-apis-write-others](../includes/rbac-for-apis/rbac-authentication-methods-apis-write-others.md)]

## HTTP request
Assign a hardware OATH authentication method to yourself.
<!-- {
Expand Down Expand Up @@ -124,7 +126,6 @@ Content-Type: application/json

---


### Response

The following example shows the response.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
-->
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-delete-hardwareoathdevices-permissions.md)]

[!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]

## HTTP request

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

---


### Response

The following example shows the response.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
-->
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-list-hardwareoathdevices-permissions.md)]

[!INCLUDE [rbac-authentication-methods-policy-apis-read](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-read.md)]

## HTTP request

<!-- {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
-->
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-post-hardwareoathdevices-permissions.md)]

[!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]

## HTTP request

<!-- {
Expand Down
3 changes: 2 additions & 1 deletion api-reference/beta/api/authenticationmethoddevice-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ Choose the permission or permissions marked as least privileged for this API. Us
-->
[!INCLUDE [permissions-table](../includes/permissions/authenticationmethoddevice-post-hardwareoathdevices-permissions.md)]

[!INCLUDE [rbac-authentication-methods-policy-apis-write](../includes/rbac-for-apis/rbac-authentication-methods-policy-apis-write.md)]

## HTTP request

<!-- {
Expand Down Expand Up @@ -133,7 +135,6 @@ Content-Type: application/json

---


### Response

The following example shows the response.
Expand Down
106 changes: 106 additions & 0 deletions api-reference/beta/api/call-startrecording.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
---
title: "call: startRecording"
ms.date: 11/15/2024
description: "Start the recording of a call."
author: "calvintang"
ms.localizationpriority: medium
ms.subservice: "cloud-communications"
doc_type: apiPageType
---

# call: startRecording

Namespace: microsoft.graph

[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]

Start the recording of a call.

[!INCLUDE [national-cloud-support](../../includes/global-us.md)]

## Permissions

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).

<!-- { "blockType": "permissions", "name": "call_startrecording" } -->
[!INCLUDE [permissions-table](../includes/permissions/call-startrecording-permissions.md)]

## HTTP request
<!-- { "blockType": "ignored" } -->

```http
POST /communications/calls/{id}/microsoft.graph.StartRecording
```

## Request headers

| Name | Description |
|:--------------|:--------------------------|
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
| Content-type | application/json. Required. |

## Request body

Don't supply a request body for this method.

## Response

This method returns a `202 Accepted` response code and a [startRecordingOperation](../resources/startrecordingoperation.md) object created for this request.

## Example

The following example shows how to call this API.

### Request

The following example shows the request.

<!-- {
"blockType": "request",
"name": "call-startRecording"
}-->

```http
POST https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/microsoft.graph.StartRecording
```

---

### Response

The following example shows the response.

> **Note:** The response object shown here might be shortened for readability.
<!-- {
"blockType": "response",
"name": "call-startRecording",
"truncated": true,
"@odata.type": "microsoft.graph.startRecordingOperation"
} -->

```http
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/communications/calls/02000980-58ea-4bf2-bb77-8ba548da56f7/operations/2d7ab59c-f8bd-4911-8302-6d58ab60e338
{
"@odata.type": "#microsoft.graph.startRecordingOperation",
"clientContext": "clientContext-value",
"status": "running"
}
```

<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
2024-11-12 14:57:30 UTC -->
<!--
{
"type": "#page.annotation",
"description": "call: startRecording",
"keywords": "",
"section": "documentation",
"tocPath": "",
"suppressions": [
]
}
-->
Loading

0 comments on commit 0616df1

Please sign in to comment.