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.