---
title: [Automations guides and connectors] - Edit an Agent
description: Learn how to edit or modify agents in Agent OS using the Agent Builder.

url: https://www.contentstack.com/docs/agent-os/edit-an-agent
product: Automations
doc_type: documentation
audience:
  - developers
version: v1
last_updated: 2026-02-19
filename: edit-an-agent.md
---

# [Automations guides and connectors] - Edit an Agent

This page explains [Automations guides and connectors] - Edit an Agent for Automations. It is intended for developers who need to understand or implement this topic. Use it when you are setting up, configuring, or troubleshooting this feature.

## Edit an Agent

**Note:** **Agent OS** is currently in **Early Access**. Features may change and limitations may apply. We recommend using it in non-production environments until general availability. For more information, contact [support](mailto:support@contentstack.com).

Editing an agent in Agent OS allows you to update and manage configurations using the Agent Builder.

To edit an agent, follow the below steps:

1. Log into the [Contentstack account](https://www.contentstack.com/login/).
2. After logging in, click the **App Switcher** icon, then select **Agent OS** from the list.![App_Switcher_Icon.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blta53cf8e3d81561ac/6996d4c2ca1be7000834d2c5/App_Switcher_Icon.png)
3. Navigate to your project.
4. In the top navigation panel, select **Agents**. On the agents listing page, click the vertical ellipses, then click **Edit** from the dropdown.![Edit_Agent_Icon.png](https://images.contentstack.io/v3/assets/blt2d43f51baca745a8/blt46614249a7e70c27/6996d4c3db043d0008253476/Edit_Agent_Icon.png)
5. Once done, you are redirected to the Agent builder screen to edit the agent.

**Note:** Active agents **cannot** be edited. First, deactivate the agent to edit it.

## Common questions
### What is covered in [Automations guides and connectors] - Edit an Agent?
This page covers the topic described in the title and provides the steps, options, and examples needed to use it.
### Who should read [Automations guides and connectors] - Edit an Agent?
Anyone responsible for configuring, implementing, or maintaining this capability should use this page as a reference.
### When should I use this page?
Use it when you are setting up this feature, troubleshooting issues, or validating expected behavior.