Move File or Folder

Options

Field Definition Type Required
Source

Choose a source:

  • My Drive: authenticated user's OneDrive.
  • Drive ID: a specified drive by the drive's unique ID.
  • Group ID: a specified group's document library for a group by the group's unique ID.
  • User ID: a specified user by the user's unique ID.
Dropdown TRUE

Input

Field Definition Type Required
Drive      
Drive ID

Unique ID for the drive requested.

Appears when Drive ID is selected from the Source option.

String TRUE
Group      
Group ID

Unique ID for the group which owns the document library.

Appears when Group ID is selected from the Source option.

String TRUE
User      
User ID

Unique ID for the user object who owns the drive item.

Appears when User ID is selected from the Source option.

String TRUE
Source      
File or Folder ID Unique ID of the file or folder to move. String TRUE
Destination      
Folder ID Unique ID of the parent folder where the file or folder is moved. String TRUE
Name Display name of the file or folder to move. If left empty, the moved file or folder retains its existing name. String FALSE

Output

Field Definition Type
File or Folder ID Unique ID of the file or folder. String
Name Name of the file or folder. String
Type Type of the drive item. Possible values are: File or Folder. String
Parent Reference    
Drive ID Unique ID of the drive. String
Drive Type Describes the type of drive represented by this resource. String
Parent Folder ID Unique ID of the parent folder. String
Path File system path of the file or folder. String
Created By    
Name Name of the user who created the file or folder. String
Email Email address of the user who moved the file or folder.  
User ID Unique ID of the user. String
Created Date Date and time of item creation. Date and Time
Last Modified By    
Name Name of the user who modified the file or folder. String
Email Email address of the user who modified the file or folder. String
User ID Unique ID of the user. String
Last Modified Identity of the folder which last modified the file or folder. String
Folder    
Child Count Number of children contained immediately within this container. Number
File    
Mime Type MIME type for the file. This is determined by logic on the server and might not be the value provided when the file was uploaded. String
Web URL    
CTag ETag for the content of the item. This eTag is not changed if only the metadata is changed. String
ETag ETag for the entire item (metadata + content). String
Size Size of the item in bytes. Number

Additional information

  • Users who want to rename the file or folder that is being moved, specify the Name input field with the file extension if moving a file. Leave the Name input field empty if you are not renaming the file or folder.

  • Items cannot be moved between drives, users or groups using this request. For example, if the source file or folder in Drive A is moved to a destination folder in Drive B, then the Source file or folder is added to the root directory of Drive A, not the intended folder in Drive B.

  • By default, users cannot move a file or folder from a drive, users or group that belongs to another user.

Related topics

OneDrive connector

About the elements of Okta Workflows

Microsoft Graph API documentation