Merge branch 'main' into notes-api-beta-docs

Author: rajeshvulla

api-reference/beta/api/driveitem-get-content-format.md

@@ -42,7 +42,9 @@ GET /drive/root:/{path and filename}:/content?format={format}
 
 | Parameter      | Type  | Description                                                    |
 |:----------|:-------|:---------------------------------------------------------------|
-| _format_  | string | Specify the format the item's content should be downloaded as. |
+| format | String | Specify the format the item's content should be downloaded as. |
+| height | Int32  | The desired height of the converted image in pixels. Required when `format=jpg`. |
+| width | Int32  | The desired width of the converted image in pixels. Required when `format=jpg`. |
 
 The following values are valid for the **format** parameter:
 

api-reference/beta/api/activities-list.md …-reference/beta/api/itemactivity-list.mdapi-reference/beta/api/activities-list.md renamed to api-reference/beta/api/itemactivity-list.md api-reference/beta/api/activities-list.md renamed to api-reference/beta/api/itemactivity-list.md

@@ -1,21 +1,20 @@
 ---
 author: daspek
 title: List activities
-description: "List the recent activities that took place on an item or under a hierarchy."
+description: "List the recent activities that took place on a drive, list, item, or within an item hierarchy."
 ms.localizationpriority: medium
 doc_type: apiPageType
 ms.subservice: onedrive
 ms.date: 04/04/2024
 ---
-# List activities (preview)
+# List activities
 
 Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-List the recent [activities](../resources/itemactivity.md) that took place on an item or under a hierarchy.
+List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy.
 
->**Note:** Activities is in a limited preview and is not yet available to all tenants.
 
 [activities]: ../resources/itemactivity.md
 
@@ -25,8 +24,8 @@ List the recent [activities](../resources/itemactivity.md) that took place on an
 
 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": "activities_list" } -->
-[!INCLUDE [permissions-table](../includes/permissions/activities-list-permissions.md)]
+<!-- { "blockType": "permissions", "name": "itemactivity_list" } -->
+[!INCLUDE [permissions-table](../includes/permissions/itemactivity-list-permissions.md)]
 
 ## HTTP request
 
@@ -39,48 +38,21 @@ GET /sites/{site-id}/lists/{list-id}/activities
 GET /sites/{site-id}/lists/{list-id}/items/{item-id}/activities
 ```
 
+## Optional query parameters
+
+This method doesn't support [OData query parameters](/graph/query-parameters) to customize the response.
+
 ## Example
 
 ### Request
 
 
-# [HTTP](#tab/http)
 <!-- { "blockType": "request", "name": "list-activities" } -->
 
 ```msgraph-interactive
 GET https://graph.microsoft.com/beta/me/drive/activities
 ```
 
-# [C#](#tab/csharp)
-[!INCLUDE [sample-code](../includes/snippets/csharp/list-activities-csharp-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Go](#tab/go)
-[!INCLUDE [sample-code](../includes/snippets/go/list-activities-go-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Java](#tab/java)
-[!INCLUDE [sample-code](../includes/snippets/java/list-activities-java-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [JavaScript](#tab/javascript)
-[!INCLUDE [sample-code](../includes/snippets/javascript/list-activities-javascript-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [PHP](#tab/php)
-[!INCLUDE [sample-code](../includes/snippets/php/list-activities-php-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [PowerShell](#tab/powershell)
-[!INCLUDE [sample-code](../includes/snippets/powershell/list-activities-powershell-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
-# [Python](#tab/python)
-[!INCLUDE [sample-code](../includes/snippets/python/list-activities-python-snippets.md)]
-[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
-
----
-
 ### Response
 
 <!-- { "blockType": "response", "@type": "Collection(microsoft.graph.itemActivity)", "truncated": true } -->

…rmissions/activities-list-permissions.md …issions/itemactivity-list-permissions.mdapi-reference/beta/includes/permissions/activities-list-permissions.md renamed to api-reference/beta/includes/permissions/itemactivity-list-permissions.md api-reference/beta/includes/permissions/activities-list-permissions.md renamed to api-reference/beta/includes/permissions/itemactivity-list-permissions.md

@@ -20,16 +20,25 @@ Used for the **stages** property of approval settings in an [access package assi
 ## Properties
 |Property|Type|Description|
 |:---|:---|:---|
+|approverInformationVisibility|[approverInformationVisibility](#approverinformationvisibility-values)|Indicates whether approver information is visible to the requestor. The possible values are: `default`, `notVisible`, `visible`, `unknownFutureValue`.|
 |durationBeforeAutomaticDenial|Duration|The number of days that a request can be pending a response before it is automatically denied.|
 |durationBeforeEscalation|Duration|If escalation is required, the time a request can be pending a response from a primary approver.|
-|escalationApprovers|[subjectSet](../resources/subjectset.md) collection|If escalation is enabled and the primary approvers do not respond before the escalation time, the escalationApprovers are the users who will be asked to approve requests. |
+|escalationApprovers|[subjectSet](../resources/subjectset.md) collection|If escalation is enabled and the primary approvers don't respond before the escalation time, the escalationApprovers are the users who will be asked to approve requests. |
 |fallbackEscalationApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who are the fallback escalation approvers.|
 |fallbackPrimaryApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who are the fallback primary approvers.|
-|approverInformationVisibility|[approverInformationVisibility](approverInformationVisibility.md)|Indicates whether approver information is visible to the requestor. The possible values are: `no`, `yes`, `default`, `unknownFutureValue`.|
 |isApproverJustificationRequired|Boolean|Indicates whether the approver is required to provide a justification for approving a request.|
 |isEscalationEnabled|Boolean|If `true`, then one or more **escalationApprovers** are configured in this approval stage.|
 |primaryApprovers|[subjectSet](../resources/subjectset.md) collection|The subjects, typically users, who will be asked to approve requests. A collection of [singleUser](singleuser.md), [groupMembers](groupmembers.md), [requestorManager](requestormanager.md), [internalSponsors](internalsponsors.md), [externalSponsors](externalsponsors.md), or [targetUserSponsors](targetusersponsors.md).|
 
+### approverInformationVisibility values
+
+| Member             | Description                                                        |
+|:-------------------|:-------------------------------------------------------------------|
+| default            | Use the default system setting for approver information visibility.|
+| notVisible         | Approver information isn't visible to the requestor.             |
+| visible            | Approver information is visible to the requestor.                 |
+| unknownFutureValue | Evolvable enumeration sentinel value. Don't use.                  |
+
 ## Relationships
 None.
 

api-reference/beta/resources/accesspackageapprovalstage.md

@@ -23,7 +23,7 @@ In PIM, defines the settings of the approval stages in a [unifiedRoleManagementP
 | Property                     | Type                      | Description |
 | :--------------------------- | :------------------------ | :---------- |
 | approvalStageTimeOutInDays |Int32 | The number of days that a request can be pending a response before it is automatically denied. |
-| approverInformationVisibility|[approverInformationVisibility](approverInformationVisibility.md) | Indicates whether approver information is visible to the requestor. The possible values are: `no`, `yes`, `default`, `unknownFutureValue`. |
+| approverInformationVisibility|[approverInformationVisibility](accesspackageapprovalstage.md#approverinformationvisibility-values) | Indicates whether approver information is visible to the requestor. The possible values are: `default`, `notVisible`, `visible`, `unknownFutureValue`. |
 | isApproverJustificationRequired |Boolean | Indicates whether the approver is required to provide a justification for approving a request. |
 | isEscalationEnabled |Boolean | If true, then one or more escalation approvers are configured in this approval stage. |
 | escalationTimeInMinutes |Int32 | If escalation is required, the time a request can be pending a response from a primary approver. |

api-reference/beta/resources/approvalstage.md

@@ -25,7 +25,7 @@ Users without a OneDrive license may not have a default drive available.
 | [List drive][drive-list]                                   | drive collection        |Retrieve the list of drive resources available for a target user, group, or site.|
 | [Get drive][drive-get]                                     | drive                       | Get metadata about a drive.|
 | [Get drive root][item-get]                                 | [driveItem][]               | Get root folder of a drive.|
-| [List activities][drive-activities]                        | [itemActivity][] collection | List activities that occurred under the drive.|
+| [List activities][drive-activities]                        | [itemActivity][] collection | List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy. |
 | [List followed items][drive-following]                     | [driveItem][] collection    | List the user's followed driveItems.|
 | [List children][item-children]                             | [driveItem][] collection    | List children of the root folder of a drive.|
 | [List changes][item-changes]                               | [driveItem][] collection    | List changes for all driveItems in the drive.|
@@ -129,7 +129,7 @@ The **drive** resource is derived from [**baseItem**](baseitem.md) and inherits
 [list]: list.md
 [quota-facet]: quota.md
 [drive-resource]: drive.md
-[drive-activities]: ../api/activities-list.md
+[drive-activities]: ../api/itemactivity-list.md
 [drive-following]: ../api/drive-list-following.md
 [drive-get]: ../api/drive-get.md
 [drive-list]: ../api/drive-list.md

api-reference/beta/resources/approverinformationvisibility.md

@@ -45,6 +45,7 @@ Items with the **folder** facet act as containers of items and therefore have a
 | [Get item](../api/driveitem-get.md)                                          | [driveItem](../resources/driveitem.md) |Retrieve the metadata for a **driveItem** in a drive.|
 | [Get analytics][]                                                            | [itemAnalytics][] | Get analytics for this resource.|
 | [Get activities by interval][]                                               | [itemActivityStat](../resources/itemactivitystat.md) | Get a collection of **itemActivityStats** within the specified time interval.|
+| [Get recent activities](../api/itemactivity-list.md)       | [itemActivity](../resources/itemactivity.md) collection | List the recent [activities](../resources/itemactivity.md) that took place on a [drive](../resources/drive.md), [list](../resources/list.md), item, or within an item hierarchy. |
 | [List children](../api/driveitem-list-children.md)                           | [driveItem](../resources/driveitem.md) collection | Return a collection of **driveItems** in the children relationship of a **driveItem**.|
 | [List versions](../api/driveitem-list-versions.md)                           | [driveItemVersion][] collection | Retrieve the versions of a file in the current user's drive.|
 | [Create folder](../api/driveitem-post-children.md)                             | [driveItem](../resources/driveitem.md) | Create a **driveItem** in the specified drive.|
@@ -270,7 +271,6 @@ The **driveItem** resource is derived from [**baseItem**][baseItem] and inherits
 [itemReference]: itemreference.md
 [itemRetentionLabel]: itemretentionlabel.md
 [geoCoordinates]: geocoordinates.md
-[List activities]: ../api/activities-list.md
 [listItem]: listitem.md
 [malware]: malware.md
 [media]: media.md

api-reference/beta/resources/drive.md

@@ -18,17 +18,17 @@ Represents more detail about an undergraduate, graduate, postgraduate degree, or
 
 ## Properties
 
-| Property     | Type        | Description                                                   |
-|:-------------|:------------|:--------------------------------------------------------------|
-|abbreviation  |String       |Shortened name of the degree or program (example: PhD, MBA)    |
-|activities    |String       |Extracurricular activities undertaken alongside the program.   |
-|awards        |String       |Any awards or honors associated with the program.              |
-|description   |String       |Short description of the program provided by the user.         |
-|displayName   |String       |Long-form name of the program that the user provided.          |
-|fieldsOfStudy |String       |Majors and minors associated with the program. (if applicable) |
-|grade         |String       |The final grade, class, GPA, or score.                          |
-|notes         |String       |More notes the user provided.                        |
-|webUrl        |String       |Link to the degree or program page.                            |
+| Property     | Type             | Description                                                   |
+|:-------------|:-----------------|:--------------------------------------------------------------|
+|abbreviation  |String            |Shortened name of the degree or program, for example, `PhD` and `MBA`.    |
+|activities    |String collection |Extracurricular activities undertaken alongside the program.   |
+|awards        |String collection |Any awards or honors associated with the program.              |
+|description   |String            |Short description of the program provided by the user.         |
+|displayName   |String            |Long-form name of the program that the user provided.          |
+|fieldsOfStudy |String collection |Majors and minors associated with the program, if applicable. |
+|grade         |String            |The final grade, class, grade point average (GPA), or score.                         |
+|notes         |String            |More notes provided by the user.                                  |
+|webUrl        |String            |Link to the degree or program page.                            |
 
 ## JSON representation
 
@@ -46,11 +46,11 @@ The following JSON representation shows the resource type.
 ```json
 {
   "abbreviation": "String",
-  "activities": "String",
-  "awards": "String",
+  "activities": ["String"],
+  "awards": ["String"],
   "description": "String",
   "displayName": "String",
-  "fieldsOfStudy": "String",
+  "fieldsOfStudy": ["String"],
   "grade": "String",
   "notes": "String",
   "webUrl": "String"

api-reference/beta/resources/driveitem.md

@@ -969,15 +969,6 @@ Namespace: microsoft.graph
 | remoteDesktopToken |
 | refreshToken       |
 
-### approverInformationVisibility values
-
-| Member |
-| ---- |
-| no |
-| yes |
-| default |
-| unknownFutureValue |
-
 ### protocolType values
 
 | Member |