microsoft-graph 2.23.0 → 2.25.0

package/docs/api/addressOffset.md

@@ -0,0 +1,137 @@
+[Microsoft Graph SDK](README.md) / addressOffset
+
+# addressOffset
+
+Utilities for converting between spreadsheet column/row addresses and offsets.
+
+## Functions
+
+### columnAddressToOffset()
+
+> **columnAddressToOffset**(`column`): [`ColumnOffset`](Column.md#columnoffset)
+
+Defined in: [src/services/addressOffset.ts:16](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressOffset.ts#L16)
+
+Converts a column address (e.g., "A") to a zero-based column offset.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `column` | [`Uppercase`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html#uppercasestringtype)\<`string`\> | The column address. |
+
+#### Returns
+
+[`ColumnOffset`](Column.md#columnoffset)
+
+The zero-based column offset.
+
+***
+
+### columnOffsetToAddress()
+
+> **columnOffsetToAddress**(`offset`): [`Uppercase`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html#uppercasestringtype)\<`string`\>
+
+Defined in: [src/services/addressOffset.ts:29](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressOffset.ts#L29)
+
+Converts a zero-based column offset to a column address (e.g., "A").
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `offset` | [`ColumnOffset`](Column.md#columnoffset) | The zero-based column offset. |
+
+#### Returns
+
+[`Uppercase`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html#uppercasestringtype)\<`string`\>
+
+The column address.
+
+***
+
+### ~~offsetToColumnAddress()~~
+
+> **offsetToColumnAddress**(`offset`): [`Uppercase`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html#uppercasestringtype)\<`string`\>
+
+Defined in: [src/services/addressOffset.ts:41](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressOffset.ts#L41)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `offset` | [`ColumnOffset`](Column.md#columnoffset) |
+
+#### Returns
+
+[`Uppercase`](https://www.typescriptlang.org/docs/handbook/2/template-literal-types.html#uppercasestringtype)\<`string`\>
+
+#### Deprecated
+
+Use columnOffsetToAddress instead.
+
+***
+
+### ~~offsetToRowAddress()~~
+
+> **offsetToRowAddress**(`offset`): `` `${number}` ``
+
+Defined in: [src/services/addressOffset.ts:64](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressOffset.ts#L64)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `offset` | [`RowOffset`](Row.md#rowoffset) |
+
+#### Returns
+
+`` `${number}` ``
+
+#### Deprecated
+
+Use rowOffsetToAddress instead.
+
+***
+
+### rowAddressToOffset()
+
+> **rowAddressToOffset**(`row`): [`RowOffset`](Row.md#rowoffset)
+
+Defined in: [src/services/addressOffset.ts:50](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressOffset.ts#L50)
+
+Converts a row address (e.g., "1") to a zero-based row offset.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `row` | `` `${number}` `` | The row address. |
+
+#### Returns
+
+[`RowOffset`](Row.md#rowoffset)
+
+The zero-based row offset.
+
+***
+
+### rowOffsetToAddress()
+
+> **rowOffsetToAddress**(`offset`): `` `${number}` ``
+
+Defined in: [src/services/addressOffset.ts:59](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/addressOffset.ts#L59)
+
+Converts a zero-based row offset to a row address (e.g., "1").
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `offset` | [`RowOffset`](Row.md#rowoffset) | The zero-based row offset. |
+
+#### Returns
+
+`` `${number}` ``
+
+The row address.

package/docs/api/applyWorkbookTableColumnFilter.md

@@ -0,0 +1,34 @@
+[Microsoft Graph SDK](README.md) / applyWorkbookTableColumnFilter
+
+# applyWorkbookTableColumnFilter
+
+Apply a filter to a workbook table column.
+
+## Functions
+
+### applyWorkbookTableColumnFilter()
+
+> **applyWorkbookTableColumnFilter**(`columnRef`, `criteria`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+Defined in: [src/operations/workbookTable/applyWorkbookTableColumnFilter.ts:20](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookTable/applyWorkbookTableColumnFilter.ts#L20)
+
+Apply a filter to a workbook table column.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `columnRef` | [`WorkbookTableColumnRef`](WorkbookTable-1.md#workbooktablecolumnref) | Reference to the table column. |
+| `criteria` | `WorkbookFilterCriteria` | Filter criteria to apply. |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+#### Remarks
+
+If you intend to immediately read the visible range from this table after changing the filter you must perform a `calculateWorksheet` otherwise the changes may not yet have taken effect.
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/filter-apply

package/docs/api/autoFitWorkbookRangeColumns.md

@@ -0,0 +1,29 @@
+[Microsoft Graph SDK](README.md) / autoFitWorkbookRangeColumns
+
+# autoFitWorkbookRangeColumns
+
+Auto-fit the columns in a range.
+
+## Functions
+
+### autoFitWorkbookRangeColumns()
+
+> **autoFitWorkbookRangeColumns**(`rangeRef`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+Defined in: [src/operations/workbookRange/autoFitWorkbookRangeColumns.ts:18](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookRange/autoFitWorkbookRangeColumns.ts#L18)
+
+Auto-fit the columns in a range.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `rangeRef` | [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref) | Reference to the range. * |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/rangeformat-autofitcolumns

package/docs/api/azureApplicationCredentials.md

@@ -0,0 +1,31 @@
+[Microsoft Graph SDK](README.md) / azureApplicationCredentials
+
+# azureApplicationCredentials
+
+Azure application credential helpers for authentication and token management.
+
+## Functions
+
+### getCurrentAccessToken()
+
+> **getCurrentAccessToken**(`tenantId`, `clientId`, `clientSecret`, `scope`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<[`AccessToken`](AccessToken.md#accesstoken)\>
+
+Defined in: [src/services/azureApplicationCredentials.ts:22](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/azureApplicationCredentials.ts#L22)
+
+Retrieves the current access token for a given client and scope.
+If a valid token is cached, it will be returned; otherwise, a new token will be requested.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `tenantId` | [`AzureTenantId`](AzureApplicationCredentials-1.md#azuretenantid) | The tenant ID. |
+| `clientId` | [`AzureClientId`](AzureApplicationCredentials-1.md#azureclientid) | The client ID. |
+| `clientSecret` | [`AzureClientSecret`](AzureApplicationCredentials-1.md#azureclientsecret) | The client secret. |
+| `scope` | [`Scope`](AzureApplicationCredentials-1.md#scope) | The scope for which the token is requested. |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<[`AccessToken`](AccessToken.md#accesstoken)\>
+
+A promise that resolves to the access token.

package/docs/api/batch.md

@@ -0,0 +1,21 @@
+[Microsoft Graph SDK](README.md) / batch
+
+# batch
+
+Constants and helpers for batching Microsoft Graph API requests.
+
+## Variables
+
+### maxCellsPerRequest
+
+> `const` **maxCellsPerRequest**: `10000` = `10000`
+
+Defined in: [src/services/batch.ts:13](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/batch.ts#L13)
+
+Maximum number of cells that can be retrieved in a single request, unless overwritten.
+
+#### Remarks
+
+The Microsoft Graph API documentation does not specify a fixed maximum number of cells that can be retrieved in a single request.
+However, it mentions that large ranges may result in errors due to resource constraints. Additionally, discussions in developer
+communities suggest that requests exceeding 10,000 cells may encounter issues.

package/docs/api/calculateWorkbook.md

@@ -0,0 +1,52 @@
+[Microsoft Graph SDK](README.md) / calculateWorkbook
+
+# calculateWorkbook
+
+Recalculate a workbook.
+
+## Functions
+
+### calculateWorkbook()
+
+> **calculateWorkbook**(`workbookRef`, `calculationType`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+Defined in: [src/operations/workbook/calculateWorkbook.ts:18](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbook/calculateWorkbook.ts#L18)
+
+Recalculate a workbook.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `workbookRef` | [`WorkbookRef`](Workbook.md#workbookref) | `undefined` | Reference to the workbook to be recalculated. |
+| `calculationType` | `"Full"` \| `"Recalculate"` \| `"FullRebuild"` | `"Recalculate"` | Type of recalculation to perform. Can be "Recalculate", "Full", or "FullRebuild". * |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/workbookapplication-calculate
+
+***
+
+### ~~recalculateWorkbook()~~
+
+> **recalculateWorkbook**(`workbookRef`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+Defined in: [src/operations/workbook/calculateWorkbook.ts:38](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbook/calculateWorkbook.ts#L38)
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `workbookRef` | [`WorkbookRef`](Workbook.md#workbookref) | Reference to the workbook to be recalculated. |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+#### Deprecated
+
+Use calculateWorkbook instead.

package/docs/api/cartesianAddress.md

@@ -0,0 +1,49 @@
+[Microsoft Graph SDK](README.md) / cartesianAddress
+
+# cartesianAddress
+
+Utilities for converting between A1 addresses and Cartesian coordinates.
+
+## Functions
+
+### addressToCartesian()
+
+> **addressToCartesian**(`address`): [`Cartesian`](Cartesian.md#cartesian)
+
+Defined in: [src/services/cartesianAddress.ts:19](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/cartesianAddress.ts#L19)
+
+Converts a cell range address to Cartesian coordinates.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `address` | [`Address`](Address.md#address) | The cell range address (e.g., "A1:C3"). |
+
+#### Returns
+
+[`Cartesian`](Cartesian.md#cartesian)
+
+The Cartesian representation of the address, with start and end coordinates.
+
+***
+
+### cartesianToAddress()
+
+> **cartesianToAddress**(`cartesian`): [`Address`](Address.md#address)
+
+Defined in: [src/services/cartesianAddress.ts:37](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/cartesianAddress.ts#L37)
+
+Converts Cartesian coordinates to a cell range address.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `cartesian` | [`Cartesian`](Cartesian.md#cartesian) | The Cartesian coordinates, including start (ax, ay) and end (bx, by). |
+
+#### Returns
+
+[`Address`](Address.md#address)
+
+The cell range address (e.g., "A1:C3").

package/docs/api/clearWorkbookRange.md

@@ -0,0 +1,30 @@
+[Microsoft Graph SDK](README.md) / clearWorkbookRange
+
+# clearWorkbookRange
+
+Clear a range - content, formatting, or both.
+
+## Functions
+
+### clearWorkbookRange()
+
+> **clearWorkbookRange**(`rangeRef`, `applyTo`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+Defined in: [src/operations/workbookRange/clearWorkbookRange.ts:19](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookRange/clearWorkbookRange.ts#L19)
+
+Clear a range - content, formatting, or both.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `rangeRef` | [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref) | `undefined` | Reference to the range to be cleared. |
+| `applyTo` | `"All"` \| `"Formats"` \| `"Contents"` | `"All"` | What to clear - "All", "Formats", or "Contents". * |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/range-delete

package/docs/api/clearWorkbookTableColumnFilters.md

@@ -0,0 +1,29 @@
+[Microsoft Graph SDK](README.md) / clearWorkbookTableColumnFilters
+
+# clearWorkbookTableColumnFilters
+
+Clear all filters from a workbook table.
+
+## Functions
+
+### clearWorkbookTableColumnFilters()
+
+> **clearWorkbookTableColumnFilters**(`tableRef`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+Defined in: [src/operations/workbookTable/clearWorkbookTableFilters.ts:17](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookTable/clearWorkbookTableFilters.ts#L17)
+
+Clear all filters from a workbook table.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `tableRef` | [`WorkbookTableRef`](WorkbookTable-1.md#workbooktableref) | Reference to the table. |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/table-clearfilters

package/docs/api/closeWorkbookSession.md

@@ -0,0 +1,33 @@
+[Microsoft Graph SDK](README.md) / closeWorkbookSession
+
+# closeWorkbookSession
+
+Close an existing workbook session.
+
+## Functions
+
+### closeWorkbookSession()
+
+> **closeWorkbookSession**(`workbookRef`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+Defined in: [src/operations/workbookSession/closeWorkbookSession.ts:19](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookSession/closeWorkbookSession.ts#L19)
+
+Close an existing workbook session.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `workbookRef` | [`WorkbookRef`](Workbook.md#workbookref) | Reference to the workbook. * |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`void`\>
+
+#### Throws
+
+[InvalidArgumentError](InvalidArgumentError.md) if the session ID is not provided.
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/workbook-closesession

package/docs/api/context.md

@@ -0,0 +1,126 @@
+[Microsoft Graph SDK](README.md) / context
+
+# context
+
+Context creation and management utilities for Microsoft Graph API authentication.
+
+## Functions
+
+### createAccessTokenContext()
+
+> **createAccessTokenContext**(`accessToken`): [`ContextRef`](Context-1.md#contextref)
+
+Defined in: [src/services/context.ts:30](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/context.ts#L30)
+
+Create a context using a static access token.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `accessToken` | [`AccessToken`](AccessToken.md#accesstoken) |
+
+#### Returns
+
+[`ContextRef`](Context-1.md#contextref)
+
+#### Remarks
+
+You must manually handle renewal of the access token with this approach.
+
+***
+
+### createClientSecretContext()
+
+> **createClientSecretContext**(`tenantId`, `clientId`, `clientSecret`, `scope`): [`ContextRef`](Context-1.md#contextref)
+
+Defined in: [src/services/context.ts:18](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/context.ts#L18)
+
+Create a context using the client secret credential.
+
+#### Parameters
+
+| Parameter | Type | Default value |
+| ------ | ------ | ------ |
+| `tenantId` | [`AzureTenantId`](AzureApplicationCredentials-1.md#azuretenantid) | `undefined` |
+| `clientId` | [`AzureClientId`](AzureApplicationCredentials-1.md#azureclientid) | `undefined` |
+| `clientSecret` | [`AzureClientSecret`](AzureApplicationCredentials-1.md#azureclientsecret) | `undefined` |
+| `scope` | [`Scope`](AzureApplicationCredentials-1.md#scope) | `defaultScope` |
+
+#### Returns
+
+[`ContextRef`](Context-1.md#contextref)
+
+***
+
+### createContext()
+
+> **createContext**(`accessTokenGenerator`): [`ContextRef`](Context-1.md#contextref)
+
+Defined in: [src/services/context.ts:38](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/context.ts#L38)
+
+Create a context using a given access token generator.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `accessTokenGenerator` | [`AccessTokenGenerator`](AccessTokenGenerator.md#accesstokengenerator) |
+
+#### Returns
+
+[`ContextRef`](Context-1.md#contextref)
+
+***
+
+### createDefaultClientSecretContext()
+
+> **createDefaultClientSecretContext**(): [`ContextRef`](Context-1.md#contextref)
+
+Defined in: [src/services/context.ts:49](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/context.ts#L49)
+
+Create a context using the client secret credential using environment variables AZURE_TENANT_ID, AZURE_CLIENT_ID and AZURE_CLIENT_SECRET.
+
+#### Returns
+
+[`ContextRef`](Context-1.md#contextref)
+
+***
+
+### ~~getDefaultContextRef()~~
+
+> **getDefaultContextRef**(): [`ContextRef`](Context-1.md#contextref)
+
+Defined in: [src/services/context.ts:60](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/context.ts#L60)
+
+#### Returns
+
+[`ContextRef`](Context-1.md#contextref)
+
+#### Deprecated
+
+Use `createDefaultClientSecretContext()` instead.
+
+***
+
+### ~~register()~~
+
+> **register**(`tenantId`, `clientId`, `clientSecret`): [`ContextRef`](Context-1.md#contextref)
+
+Defined in: [src/services/context.ts:67](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/context.ts#L67)
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `tenantId` | [`AzureTenantId`](AzureApplicationCredentials-1.md#azuretenantid) |
+| `clientId` | [`AzureClientId`](AzureApplicationCredentials-1.md#azureclientid) |
+| `clientSecret` | [`AzureClientSecret`](AzureApplicationCredentials-1.md#azureclientsecret) |
+
+#### Returns
+
+[`ContextRef`](Context-1.md#contextref)
+
+#### Deprecated
+
+Use `createClientSecretContext()` instead.

package/docs/api/copyDriveItem.md

@@ -0,0 +1,38 @@
+[Microsoft Graph SDK](README.md) / copyDriveItem
+
+# copyDriveItem
+
+Copy a drive item.
+
+## Functions
+
+### copyDriveItem()
+
+> **copyDriveItem**(`srcFileRef`, `dstDriveRef`, `dstFilePath`, `timeoutMs`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+Defined in: [src/tasks/copyDriveItem.ts:26](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/tasks/copyDriveItem.ts#L26)
+
+Copy a drive item.
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `srcFileRef` | [`DriveItemRef`](DriveItem-1.md#driveitemref) | `undefined` | A reference to the source file to be copied. |
+| `dstDriveRef` | [`DriveRef`](Drive-1.md#driveref) | `undefined` | Destination drive |
+| `dstFilePath` | [`DriveItemPath`](DriveItem-1.md#driveitempath) | `undefined` | Destination path where the item should be copied to. |
+| `timeoutMs` | `number` | `16000` | Timeout in milliseconds for the copy operation. |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+Reference to the new drive item.
+
+#### Remarks
+
+The underlying GraphAPI operation is asynchronous, so this function will block until the copy operation is complete or the timeout is reached.
+
+#### Throws
+
+[RequestTimeoutError](RequestTimeoutError.md) If the copy operation does not complete within the specified timeout.

package/docs/api/createDriveItem.md

@@ -0,0 +1,38 @@
+[Microsoft Graph SDK](README.md) / createDriveItem
+
+# createDriveItem
+
+Creates new drive item in the specified parent drive or folder.
+
+## Functions
+
+### createDriveItem()
+
+> **createDriveItem**(`parentRef`, `itemPath`, `contextType`, `content`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+Defined in: [src/operations/driveItem/createDriveItem.ts:23](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItem.ts#L23)
+
+Creates new drive item in the specified parent drive or folder.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `parentRef` | [`DriveRef`](Drive-1.md#driveref) \| [`DriveItemRef`](DriveItem-1.md#driveitemref) | Reference to the parent drive or folder where the drive item will be created. |
+| `itemPath` | [`DriveItemPath`](DriveItem-1.md#driveitempath) | Path (including the filename) for the new drive item. |
+| `contextType` | `string` | - |
+| `content` | [`ArrayBuffer`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) | - |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`DriveItem` & [`SiteRef`](Site-1.md#siteref) & `object` & `object`\>
+
+The newly created drive item.
+
+#### Remarks
+
+If the file already exists, it will be replaced.
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/driveitem-put-content