rollback-agent-version

Make an earlier promoted version of an agent live again. Needs the fabric:orchestrate.write grant and an admin role (OWNER, ORG_ADMIN or PROJECT_ADMIN).

The shape of result for rollback-agent-version is not recorded here: it was not captured against a live deployment. Call it once and read what comes back rather than assuming a shape.

curl -sS -X POST https://fabric.wexa.ai/mcp/$FABRIC_PROJECT_ID \
  -H "authorization: Bearer $FABRIC_API_KEY" \
  -H "Mcp-Session-Id: $MCP_SESSION_ID" \
  -H "content-type: application/json" -H "accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"rollback-agent-version","arguments":{"agent_id":"6ab1945e7566f41b5c28e303.6ab1945e83ff5845d7db96bc","version":10}}}'

curl -sS https://fabric.wexa.ai/v1/rollback-agent-version \
  -H "authorization: Bearer $FABRIC_API_KEY" \
  -H "content-type: application/json" \
  -d '{"agent_id":"6ab1945e7566f41b5c28e303.6ab1945e83ff5845d7db96bc","version":10}'

import { Fabric } from '@wexa-fabric/sdk'

const fabric = new Fabric()
const result = await fabric.rollbackAgentVersion({
  agent_id: '6ab1945e7566f41b5c28e303.6ab1945e83ff5845d7db96bc',
  version: 10
})

from wexa import Fabric

fabric = Fabric()
out = fabric.rollback_agent_version(
    agent_id="6ab1945e7566f41b5c28e303.6ab1945e83ff5845d7db96bc",
    version=10,
)

Parameters

Parameter	Type	Required	Notes
`agent_id`	string	Required	Agent id. An agent in this project.
`version`	integer	Required	The version number to make live, at least 1. Find it with `agent-versions`. A version of that agent.

Errors

ValidationError (422): the credential does not hold an admin role (OWNER, ORG_ADMIN or PROJECT_ADMIN).
NotFound (404): the agent has no promoted version to roll back to.

More details

The version you roll back to becomes promoted; the one that was live becomes rolled_back. Version numbers are not renumbered, so rolling back to v1 while v2 was live leaves v2 in the history marked rolled_back. Discover version numbers with agent-versions first.

A version exists only after a promote, and a new agent has none: agent-versions answers versions: []. The first version of an agent is promoted in the console, in Agent Simulation. No tool creates it, so this tool has nothing to make live until that has happened once.

In the console, open the agent's Version history and choose Restore this version on an earlier one. A process flow has its own rollback-flow-version; rolling a process flow back records which snapshot is live and does not rewrite its agents.

Every tool call works the same way: How every tool call works.