Any time a user publishes their agent, they actually create a new version of it. To enable organizations to have full traceability and management over their deployed agents, versions in SUPERWISE® are immutable.
A version contains all the necessary agent details to analyze an agent's behavior at a given time. This includes:

• Its agent configuration
• Its guardrail configuration
• Deployment time

Manage versions via the UI

To view all historical versions of a given agent, press the version button to see all previously created versions and an indication of the currently published one.
Using the UI, you can easily navigate to load and view the configuration of a given version by clicking on it.

Draft Mode

While editing an agent, you will be in draft mode. Draft mode indicates the ephemeral state of your configuration and helps you save your temporary configuration changes while navigating between different versions. If not published, and you leave the agent management studio context, this draft state with your configuration settings will be deleted.
Please note that because versions are immutable, you won’t be able to edit a version's configuration once loaded. To do that, you need to restore the version, which will transform the page into draft mode, overriding the previously created draft.

Unpublish Agent

The unpublish feature in SUPERWISE® provides users with a critical intermediate step between an active deployment and permanent removal. This capability allows you to "take an agent down" and halt its real-time interactions without the need to archive or delete the agent entirely. By unpublishing, the agent’s operational status is deactivated, but all of its configurations, associated datasets, and monitoring policies remain intact and fully editable. This is particularly beneficial for teams needing to perform maintenance, update guardrail settings, or refine agent logic in response to observed issues without losing the historical context or setup of the agent. It ensures that you can iterate on your agent’s governance and configuration in a "draft" state and redeploy only when ready, maintaining a clean production environment while preserving your developmental progress.

Unpublish using the SDK

sw.agent.unpublish(agent_id=<AGENT_ID>)

Manage versions via the SDK

List all versions of a given agent

versions_list = sw.agent.get_versions(agent_id=agent.id)

Get the configuration details of a given historical version of an agent

version = sw.agent.get_version_by_id(agent_id=agent.id, version_id=version.id)
agent_config = version.agent_config

To restore a previous version and publish it as a new version, send another version creation request using the previous configuration.

agent_config = old_version.agent_config
new_version = sw.agent.create_version(agent_id=agent.id, name="New version name", description="Your new description", agent_config=agent_config)