Open topic with navigation

# 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:

- AID
- AgentName and UserName
- AgentName and UID

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:9000/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.
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.

© 2018 Micro Focus or one of its affiliates | Send documentation feedback to Micro Focus Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm