AgentCopy

Allows you to copy an agent. You can use this action to set up a new agent that shares all or most of the details of an existing agent.

You must specify the agent to copy by setting one of the following parameter combinations: 

To copy the agent to a new user, set DestinationUserName. You can optionally also set DestinationAgentName.

To copy the agent to create a new agent for the same user, set DestinationAgentName.

Example

http://12.3.4.56:9030/action=AgentCopy&UserName=Administrator&AgentName=Global+Warming&DestinationUserName=NewUser&DestinationAgentName=Global

This action copies the Global Warming agent details for the Administrator user to the Global agent for the NewUser user.

Required Parameters

You must set at least one of the following parameters.

Parameter Description
AgentName The name of the agent to copy.
AID The agent ID of the agent to copy.
DestinationAgentName The name of the new agent.
DestinationUserName The user name of the user that the new agent belongs to.
UID The ID of the user that the agent to copy belongs to.
UserName The user name of the user that the agent to copy belongs to.

Optional Parameters

This action accepts the following optional parameters.

Parameter Description
DeferLogin Use another system for user authentication.
EmailAddress The e-mail address of the user.
FieldFieldName A field for the new agent.
InputEncoding The encoding of the AgentName and UserName values.
OutputEncoding Converts the encoding of the text that the action returns.
Security A field for the user to store user security details.

This action accepts the following standard ACI action parameters.

Parameter Description
ActionID A string to use to identify an ACI action.
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.