Rename, duplicate, transfer, or delete an agent
Every agent has a menu with actions for renaming, duplicating, moving, and deleting it. This article walks through each one.
Open the agent menu
- In the left navigation, click Agents.
- Find the agent you want to change in your list of agents. If you don't see the full list, open the Your agents page.
- Click the three-dot button on the agent.
The menu shows Edit, Rename, Duplicate, Transfer, and Delete. Edit opens the agent itself. The other four are covered below.
Rename or duplicate
To rename an agent:
- Open the agent menu and click Rename.
- In the Rename Agent window, type the new name in the Agent Name field. It starts out filled with the current name.
- Click Save. Click Cancel to keep the old name.
To duplicate an agent:
- Open the agent menu and click Duplicate.
- Wait while the menu item reads Duplicating.... You can't start a second copy of the same agent until it finishes.
Duplicating is a good way to experiment. Make a copy, change the copy, and the original stays as it was.
Transfer or delete
Transfer an agent to another organization
Transferring moves an agent from your current organization (workspace) to a different one. To transfer an agent, you need the owner, admin, or editor role in the organization you're moving it to. Your role in the current organization isn't what's checked.
- Open the agent menu and click Transfer.
- In the Transfer Agent window, open the Target Organization dropdown. Each organization is listed with your role in it in parentheses.
- Select the organization you want to move the agent to.
- Click Transfer.
When the move works, you'll see "Agent transferred successfully."
If the dropdown says "No available organizations," you don't have the owner, admin, or editor role in any other organization. Ask an owner or admin of the target organization to give you one of those roles, then try again.
Delete an agent
Deleting is permanent. It removes the agent, its code, its secrets, its scheduled tasks, and all of its run history. You can't undo it. If you only want to move the agent somewhere else, use Transfer instead.
- Open the agent menu and click Delete.
- Read the confirmation in the Delete Agent window. It names the agent you're about to remove.
- Click Delete to confirm, or Cancel to back out.
The agent disappears from your list once the deletion finishes.
Did this answer your question?
Your feedback helps us improve.
