---
title: "Manage Agent Versions with Drafts and Publishing"
icon: "code-branch"
---

# Manage Agent Versions with Drafts and Publishing

Agent Version Control allows you to manage changes to your agents by separating work-in-progress drafts from what's live in production, giving you full control over when updates are deployed.

## Understanding Agent Version Control

Agent Version Control distinguishes between your editable **Drafts** and stable **Published Versions**, ensuring a controlled development and deployment workflow.

### How it Works

*   You always make changes in a draft. Drafts are tied to you, and you can have as many as you want at once.
*   Changes made in a **Draft** do not affect live users or automations. Your active interfaces and triggers continue to use the last **Published Version**.
*   When you publish, we take a snapshot of your current draft, make it the live version, and remove the draft.
*   Every **Published Version** is retained. You can restore any past version to a draft or deprecate it to hide it from the history list.

> 💡 **Analogy:** Think of a website Content Management System (CMS). A **Draft** is like clicking "Save Draft"—only your team can preview it. **Publishing** is like pushing changes to your live domain (e.g., `acme.new`)—everyone sees the published version.

### Draft vs. Published Version

| Feature                 | Draft                                                | Published Version                                      |
| :---------------------- | :--------------------------------------------------- | :----------------------------------------------------- |
| **Purpose**             | Build, edit, and test in a safe, isolated environment. | Executes on triggers, exposes UI to users, processes webhooks. |
| **Editable?**           | ✅ Yes – this is where all changes begin.             | ❌ No – must restore to a draft first.                 |
| **Runnable?**           | ✅ Yes – using the **Test** (Playground).                | ✅ Yes – runs via triggers, interfaces, or webhooks.    |
| **Interfaces Accessible?** | Can be configured, but not viewable by users.        | ✅ Yes – users access this version.                    |
| **Webhooks Use This?**  | ✅ Yes – for testing when specified in the API call.  | ✅ Yes – API calls run this version.                   |
| **Effect of Saving**    | All drafts are auto-saved.                           | Remains unchanged.                                     |

## Managing Agent Versions: Restore and Publish

Restoring a version allows you to bring a previous version into a draft for editing. Publishing makes your draft live and active.

> 💡 **Note:** Restoring a version only copies its content into a draft; it does not automatically publish it. You must explicitly publish the draft to make it live.

### Restore a Version to a Draft

Follow these steps to copy a previous agent version into a draft for further editing:

1.  Click the **History** icon (a **clock icon**) in the top navigation bar.
2.  Locate the specific version you want to restore from the list.
3.  Click the **More actions** menu (`...`) next to the desired version.
4.  Select **Restore as Draft**.
5.  If you start editing a published version, we’ll automatically create a draft so your changes show up there.

The content of the selected version is now copied into your chosen draft, ready for your modifications.

### Publish a Draft to Go Live

Once your draft is ready, publish it to make it the active version for all users and automations.

1.  Navigate to your active draft (you'll see the **Draft** label prominently displayed).
2.  Make any necessary final changes or conduct a final review of your agent.
3.  Click the **Publish** button in the top right corner.
4.  Optionally, set a custom display name and add a version note to clearly describe the changes included in this version.
5.  Confirm the publishing action to deploy your changes.

The newly published version will now be the most recent entry at the top of your **Version History** list and will be live for all users and automations.

## Working with Drafts

Drafts are your personal, isolated workspaces for developing and testing agent changes without affecting live operations.

*   **Create New Drafts:** Click **+ New Draft** to create additional drafts. You can have up to three drafts in parallel for complex or concurrent work.
*   **Delete Drafts:** You can delete a draft at any time when it is no longer needed.


---
