MS OneDrive – Move Library Item

Updates parentReference to move an item within the same drive and can rename it through New Name. Microsoft does not support moves between drives with this operation; Parent Library Id is not a cross-drive move capability. To target the root, supply its actual item ID rather than the literal root as Parent Folder Id. The helper requires a nonblank New Name or parent reference; New Name alone performs a rename. No If-Match input is exposed.

Action details

Property	Value
Action label	MS OneDrive – Move Library Item
Category	CloudTools
Apex class and method	MoveOneDriveLibraryItem.moveLibraryItem
Input type	MoveOneDriveLibraryItem.MoveOneDriveLibraryItemInput
Output type	List<MSGraphDriveItem>
Authorization	OAuth Delegated (Authorization Code) or OAuth Application (Client Credentials).
Flow automation	Use an application connector configured as the Flow default.
Microsoft Graph operation	PATCH /v1.0/drives/{driveId}/items/{itemId} for Authorization Code Flow; otherwise PATCH /v1.0/users/{userIdOrPrincipalName}/drives/{driveId}/items/{itemId}.

Prerequisites and permissions

Configure a CloudTools Connector with Connector Type set to Microsoft 365. For delegated access, complete the current user’s Microsoft sign-in. For application access where supported, grant application permissions and administrator consent and provide the target user ID or principal name. The identity must have access to the selected drive and item.

Delegated calls require Files.ReadWrite or a supported broader write permission; application calls require Files.ReadWrite.All or Sites.ReadWrite.All. See the Microsoft operation and permissions reference.

Drive selection: For Authorization Code Flow, a populated driveId uses /drives/{driveId} and userIdOrPrincipalName is ignored. Other authorization types require userIdOrPrincipalName and use the user-scoped drive path shown above. A Library Id is a Graph drive ID and Item Id is an item within that drive; neither is a Salesforce record ID or browser URL.

Inputs

The table lists action labels, Apex field names, and Apex data types. Supply one non-null request with nonblank required text values.

Input	Apex field	Type	Required	Description
User Id or Principal Name	userIdOrPrincipalName	String	Unless Authorization Code Flow is enabled	User id or user principal name. Ignored for Authorization Code Flow.
Library Id	driveId	String	Yes	Library (drive) identifier.
Item Id	itemId	String	Yes	Library (drive) item identifier.
New Name	newName	String	No	New item name.
Parent Library Id	parentDriveId	String	No	Parent library (drive) identifier.
Parent Folder Id	parentItemId	String	No	Parent folder identifier.

The global invocable input has no connectorId field. Direct subscriber Apex and Flow calls use CloudTools connector selection. This action does not resolve replacement tokens; resolve dynamic values before invocation. See Using Token Replacements.

Outputs

Returns one MSGraphDriveItem inside a list, or an empty list when no response is mapped. Check for an empty result and a populated resource ID before subsequent operations.

Output	Apex field	Type	Description
id	id	String	Microsoft Graph resource identifier.
name	name	String	Resource name.
description	description	String	Item description.
createdDateTime	createdDateTime	String	Creation timestamp retained as text.
lastModifiedDateTime	lastModifiedDateTime	String	Last modification timestamp retained as text.
createdBy	createdBy	MSGraphDriveIdentitySet	Identity that created the resource.
lastModifiedBy	lastModifiedBy	MSGraphDriveIdentitySet	Identity that last modified the resource.
webUrl	webUrl	String	Browser link to the resource.
webDavUrl	webDavUrl	String	WebDAV URL.
size	size	Long	Size in bytes.
eTag	eTag	String	Item entity tag.
cTag	cTag	String	Content entity tag.
odataType	odataType	String	Mapped OData type.
odataEtag	odataEtag	String	Mapped OData entity tag.
downloadUrl	downloadUrl	String	Mapped @microsoft.graph.downloadUrl, when returned.
sourceUrl	sourceUrl	String	Metadata returned when populated.
conflictBehavior	conflictBehavior	String	Metadata returned when populated.
content	content	String	Content field, if mapped; do not rely on it as a download.
parentReference	parentReference	MSGraphDriveItemReference	Parent identifiers and path through driveId, id, and path.
fileSystemInfo	fileSystemInfo	MSGraphDriveFileSystemInfo	File system timestamps.
folder	folder	MSGraphDriveFolderFacet	Folder facet, including childCount.
file	file	MSGraphDriveFileFacet	File facet, including mimeType; this facet is not the file bytes.
image	image	MSGraphDriveImageFacet	Metadata returned when populated.
photo	photo	MSGraphDrivePhotoFacet	Metadata returned when populated.
audio	audio	MSGraphDriveAudioFacet	Metadata returned when populated.
video	video	MSGraphDriveVideoFacet	Metadata returned when populated.
location	location	MSGraphDriveGeoCoordinates	Metadata returned when populated.
deleted	deleted	MSGraphDriveDeletedFacet	Metadata returned when populated.
pendingOperations	pendingOperations	MSGraphDrivePendingOperations	Metadata returned when populated.
packageInfo	packageInfo	MSGraphDrivePackageFacet	Metadata returned when populated.
publication	publication	MSGraphDrivePublicationFacet	Publication state and checkout identity.
remoteItem	remoteItem	MSGraphDriveRemoteItem	Metadata returned when populated.
root	root	MSGraphDriveRootFacet	Metadata returned when populated.
searchResult	searchResult	MSGraphDriveSearchResult	Metadata returned when populated.
shared	shared	MSGraphDriveSharedFacet	Metadata returned when populated.
sharepointIds	sharepointIds	MSGraphDriveSharePointIds	Metadata returned when populated.
specialFolder	specialFolder	MSGraphDriveSpecialFolder	Metadata returned when populated.
malware	malware	MSGraphDriveMalwareFacet	Metadata returned when populated.
bundle	bundle	MSGraphDriveBundleFacet	Metadata returned when populated.
children	children	List<MSGraphDriveItem>	Child items only when included in the response.
permissions	permissions	List<MSGraphDrivePermission>	Permissions only when included in the response.
versions	versions	List<MSGraphDriveItemVersion>	Versions only when included in the response.
thumbnails	thumbnails	List<MSGraphDriveThumbnailSet>	Metadata returned when populated.
listItem	listItem	MSGraphDriveListItem	Metadata returned when populated.
analytics	analytics	MSGraphDriveItemAnalytics	Metadata returned when populated.

Optional facets depend on the item type and response. Parent Reference exposes driveId, id, and path; Folder exposes childCount; File exposes mimeType rather than bytes. Metadata timestamps remain text. This action does not automatically expand children, permissions, or versions. A downloadUrl, when supplied, is a temporary download URL; webUrl is the browser link.

Use in Flow

Add MS OneDrive – Move Library Item in Flow Builder. Use a Microsoft 365 application connector configured as Set as default for Flow automations, supply the target user and resource IDs, and handle faults. Delegated connections are not supported for CloudTools Flow automation. This implementation processes only the first request; it is not a bulk operation.

Use in custom Apex

This subscriber-org example uses the Apptigent namespace. Replace all identifiers and run in a context that permits callouts with a configured connector. The example supplies the user for application access; omit it for an already-authorized delegated connector.

Apptigent.MoveOneDriveLibraryItem.MoveOneDriveLibraryItemInput request =
    new Apptigent.MoveOneDriveLibraryItem.MoveOneDriveLibraryItemInput();
request.userIdOrPrincipalName = 'REPLACE_WITH_MICROSOFT_USER_ID_OR_UPN';
request.driveId = 'REPLACE_WITH_DRIVE_ID';
request.itemId = 'REPLACE_WITH_ITEM_OR_PARENT_ID';
request.parentItemId = 'REPLACE_WITH_DESTINATION_FOLDER_ID';

List<Apptigent.MSGraphDriveItem> results =
    Apptigent.MoveOneDriveLibraryItem.moveLibraryItem(
        new List<Apptigent.MoveOneDriveLibraryItem.MoveOneDriveLibraryItemInput>{ request }
    );

Apptigent.MSGraphDriveItem item = results.isEmpty() ? null : results[0];
String resultId = item == null ? null : item.id;
System.debug(resultId);

The example leaves exception handling, authorization setup, and presentation or persistence of the result to the calling application.

Use in a Lightning Web Component

Use moveOneDriveLibraryItem from msOneDriveConnectorLib, through MSOneDriveConnectorController. These repository c/ imports apply to an LWC in the same namespace. Complete connector authorization before use.

Connector selection limitation: The wrapper accepts a second connectorId argument, but the current controller/action path does not forward it to select the Graph connector for this operation. Calls use CloudTools default connector selection. Passing a connectorId does not guarantee that this action uses that record.

oneDriveActionExample.js

import { LightningElement } from 'lwc';
import { moveOneDriveLibraryItem, MSOneDriveObjects } from 'c/msOneDriveConnectorLib';

export default class OneDriveActionExample extends LightningElement {
    connectorId = 'REPLACE_WITH_CONNECTOR_RECORD_ID';
    result = null;
    errorMessage = '';
    isRunning = false;
    completed = false;

    async handleRun() {
        if (this.isRunning || this.completed) {
            return;
        }
        this.isRunning = true;
        this.errorMessage = '';
        try {
            const request = MSOneDriveObjects.inputs.moveOneDriveLibraryItem();
            request.userIdOrPrincipalName = 'REPLACE_WITH_MICROSOFT_USER_ID_OR_UPN';
            request.driveId = 'REPLACE_WITH_DRIVE_ID';
            request.itemId = 'REPLACE_WITH_ITEM_OR_PARENT_ID';
            request.parentItemId = 'REPLACE_WITH_DESTINATION_FOLDER_ID';
            const result = await moveOneDriveLibraryItem(request);
            if (!result?.id) {
                throw new Error('The action did not return a usable result.');
            }
            this.result = result;
            this.completed = true;
        } catch (error) {
            this.errorMessage = error.requiresInteractiveAuthorization
                ? 'Sign in to Microsoft for the connector, then try again.'
                : error.message || 'The OneDrive action failed.';
        } finally {
            this.isRunning = false;
        }
    }
}

oneDriveActionExample.html

<template>
    <lightning-button label="Run action" onclick={handleRun}
        disabled={isRunning}></lightning-button>
    <p role="alert">{errorMessage}</p>
</template>

The library resolves to one resource object or null when no response is mapped; read result.id directly.

The controller flattens parentReference into parentDriveId, parentItemId, and parentPath; folder.childCount into folderChildCount; and file.mimeType into fileMimeType. Identity names and publication metadata are also flattened. Its rawJson serializes the mapped Apex model, not the original Microsoft response.

For delegated sign-in, use getOneDriveAuthorizationState, beginOneDriveAuthorization, and createOneDriveOAuthMessageHandler. The example only reports errors. This controller path converts failures to plain Aura-handled messages, so requiresInteractiveAuthorization is not guaranteed. Use the authorization-state helper before calling and handle message-only failures.

The example avoids repeating a completed operation. Reset completed only when starting another deliberate operation. If an error leaves the outcome uncertain, inspect the item or destination before retrying. For Copy, completed means the request returned, not that the background copy has finished.

Error handling and troubleshooting

Symptom	What to check
Required fields error	Provide a nonempty request list with a non-null first item and the required identifiers. Supply the user for non-delegated connectors.
Authorization or access denied	Check connector selection, Microsoft sign-in, consent, permission type, and access to the drive or item.
Resource not found	Verify driveId, itemId, and any version or permission ID. Keep related IDs associated with their source drive.
Missing fields or items	Check Select, item type, mapping limitations, and first-page behavior. Empty results and omitted fields are not proof that a resource does not exist.
Unexpected connector	Review the connector selection limitation above and the Microsoft 365 Flow default.
Operation rejected	Inspect the Microsoft error, item state, library capability, and tenant policy. Handle exceptions or structured Result failures in the caller.