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
This step renames a file or folder on OneDrive. You provide the current path and the new name. Use this step in workflows that apply naming conventions, add version numbers to files, or standardize file names after processing.
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)