Rename File Or Folder
Prerequisite Permissions: Rename File Or Folder step in OneDrive following are the permissions needed.
| Permission type | Permission (from least to most privileged) |
|---|---|
| Delegated (work or school account) | Files.ReadWrite, Files.ReadWrite.All |
| Delegated (personal Microsoft account) | Files.ReadWrite, Files.ReadWrite.All |
Description
One Drive: Rename File or Folder step renames a file or folder in OneDrive.
Note:
- Support is provided for the Personal Drive, however, the displayed error message is not correct.
- This step cannot be used for rename or update root folder (i.e. Documents).
Reference: https://docs.microsoft.com/en-us/graph/api/driveitem-update?view=graph-rest-1.0&tabs=http
Configurations
| No. | Field Name | Description |
|---|---|---|
| Configuration: | ||
| 1 | Step Name | Name of the step. This name has to be unique in a single workflow. |
| Connection: | ||
| 2 | Client ID | Select the client ID for which you want to copy a file or folder. Note: This field is mandatory for personal accounts. |
| 3 | Checkbox: Accept value as variable/static | Leave checkbox unchecked to accept Refresh Token value from a field in the previous steps of the stream using a drop down list. Else enable checkbox for Refresh Token field to appear as Text box. |
| 4 | Refresh Token | Specify the Refresh Token provided by authorization grant flow. The data type is String. This field is mandatory. |
| 5 | Button: Test Connection | Verifies whether the connection is established or not. |
| Input Tab | ||
| Input Fields: | ||
| 1 | File Or Folder ID/Path | Provide OneDrive source file/folder path or id to rename file or folder. The data type is String. This field is mandatory. To specify OneDrive Path: For example, OneDrive path == https://organization-my.sharepoint.com/personal/xyz/Documents/demofolder/File.xlsx Provide == demofolder/File.xlsx |
| 2 | New Name | Specify the new name for file or folder. The data type is String. This field is mandatory. |
| 3 | If File Or Folder Exists On OneDrive Path | Specify from allowed values: AutoRename, Overwrite, ThrowException. Note: Overwrite only works with file. The data type is String. |
| Output Field: | ||
| 1 | Renamed Item Name | Specify the output field name. Default: RenamedItemName |
Known Issues:
Sometimes, you may see a temporary error related to the internet connectivity and network issues. The issue arises when the hostname is unresolved and the local server does not receive a response from an authoritative server. For example, you may see any of the following messages:
- login.microsoftonline.com.
OR - This is usually a temporary error during hostname resolution and means that the local server did not receive a response from an authoritative server (login.microsoftonline.com)