MCPBundler Docs
MCPBundler Docs
Back to marketplaceGetting StartedAuthenticationTutorial - Bundle to Connected Agent
API Reference
Agent A2A Tools
Agent Channels
Agent Configuration (Staging)
Agent Configuration (Versions)
Get Latest VersionGet Version DiffGet VersionList VersionsPublish VersionRename Version LabelRevert Version
Agent Tools
agents
Agents
Attachments
Auth
Billing
bundler
Bundler
Bundler Tool
Bundles
Call Campaigns
Catalog
Conversations
Credentials
Deployments
Discover
Fleet
Genesys
Insights
internal
Knowledge Base Website Sources
Knowledge Bases
MCP Listings
Media
OAuth Clients
OAuth2
Observability
Organisation roles
Organisations
Providers
Reviews
Roadmap
SCIM
Simulation Tests
Suppression
Triggers
TTS
Users
Utils
Visitors
Voices
Webhooks
Workflows
API ReferenceAgent Configuration (Versions)

Revert Version

POST
/v1/agents/{agent_id}/versions/{version}/revert

Stage an earlier version, and with publish=true publish it.

A publishing revert passes the same simulation publish gate as a publish, evaluated against the reverted staged state. The gate is checked before anything is committed, so a refused revert leaves staging as it was.

Authorization

OAuth2AuthorizationCodeBearer
AuthorizationBearer <token>

In: header

Path Parameters

agent_id*Agent Id
Formatuuid
version*Version

Query Parameters

publish?Publish
Defaultfalse
verify_locally?Verify Locally
Defaulttrue

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Publish-gate evidence for a revert with publish=true; ignored otherwise.

Default{}

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions/0/revert" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",  "version": 0,  "schema_version": 0,  "snapshot": {},  "source": "string",  "label": "string",  "published_by": "9ac9eee7-2153-423d-b22d-04e12679154a",  "published_at": "2019-08-24T14:15:22Z",  "simulation_gate_id": "762f52de-b2a5-4954-91ff-affefb839398",  "simulation_override_reason": "string",  "simulation_overridden_by": "4a2a1cc8-8c97-4e4b-ab29-8f5ffd93b9b5",  "warnings": [    "string"  ]}
{  "detail": "string",  "code": "string"}
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}

Rename Version Label

Previous Page

Agent Tools

Endpoints in the Agent Tools group.

gate_id?|

Simulation gate whose runs all passed against the reverted staged snapshot. Required with publish=true when the agent has suites marked required for publish.

override_reason?|

Publish the revert without a passing gate; recorded on the version. Ignored when no suite is required. With gate_id set, that gate is recorded as the result the override set aside.