# Copy Folder

> `UiPath.Box.Activities.Folder.CopyFolder`

`UiPath.Box.Activities.Folder.CopyFolder`

The **Copy Folder** activity uses the Box [Copy folder](https://developer.box.com/reference/post-folders-id-copy/) API to copy a specified folder (**Folder Id**) into a specified parent folder (**Parent Folder Id**) under the existing or new folder name (**New Folder Name**).

After copying the file, the activity outputs a `BoxFolder` object (**Box Folder**) that includes the properties of the copied file, including the `BoxFolder.Id` that you can use to identify the file in subsequent activities (e.g., [Delete Folder](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-delete-folder), [Rename Folder](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-rename-folder), etc.).

## How it works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-setup) steps.
2. Add the [Box Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-scope) activity to your project.
3. Add an activity or run an external process that outputs a `Folder.Id` value (e.g., [Create Folder](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-create-folder), [Search for Content](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-search-for-content), etc.).
4. Add the **Copy Folder** activity inside the **Box Scope** activity.
5. Enter values for the **Input** properties.
6. Create and enter a `BoxFolder` variable for the **Output** property.
   * Your input property values are sent in the [Copy folder](https://developer.box.com/reference/post-folders-id-copy/) API operation request.
   * The operation returns the `BoxFolder` value to your output property variable.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-187571-ba00b14f-e5fbcfac.webp)

## Properties

### Common

* **ContinueOnError** - Specifies if you want the activity to continue running when an error is thrown. This field supports only `Boolean` values.
* **DisplayName** - The display name of the activity. This field supports only `Strings` or `String` variables.

### Input

* **Folder ID** - The ID of the folder that you want to copy. This field supports only `Strings` or `String` variables. To get the **Folder ID** value, add an activity or run an external process that outputs a `Folder.Id` object (e.g., [Create Folder](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-create-folder), [Search for Content](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-search-for-content), etc.).
* **Parent Folder ID** - The ID of the parent folder where you want to copy the file. This field supports only `Strings` or `String` variables.
  + Enter a value of *"0"* to use the root folder of the application.
  + To get the ID of a folder that is not the root, use the [Search for Content](https://docs.uipath.com/activities/other/latest/legacy-integrations/box-search-for-content) activity.

### Misc

* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level.

### Options

* **New Folder Name** - The name that you want to apply to the folder. This field supports only `Strings` or `String` variables. If this property is left empty, the existing folder name is applied.

### Output

* **Box Folder** - The `BoxFolder` object that includes the folder properties. This field supports only `BoxFolder` variables. The `BoxFolder` object includes multiple [properties](https://developer.box.com/reference/resources/folder/) that you can use in other activities.
