# CategoryCopy

Allows you to copy a category, and to specify a new name and position in the category hierarchy for the copy.

NOTE: This is an administrative action that can be sent only by users that belong to an authorization role that allows the `Admin` standard role, or which enables the action explicitly. See Authorization Roles Configuration Parameters.

NOTE: A category cannot have the same name as another category with the same immediate parent category.

## Example

    http://12.3.4.56:9020/action=CategoryCopy&Category=123456789012345&Name=BotanicsCopy

This action copies the category with the ID `123456789012345` to a new category called `BotanicsCopy`, which has the same parent as the category it was copied from.

## Required Parameters

The following action parameters are required.

Parameter | Description
--- | ---
Category | The ID of the category to copy.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
BuildNow | Whether to build the category immediately.
Name | The name of the new category.
Parent | The ID of the parent category of the new category.
Recurse | Whether to copy the children of the category.
UserName | The name of the user that sends the action.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
EncryptResponse | Encrypt the output.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

_FT_HTML5_bannerTitle.htm