Roll back to a version

What it does

Brings the configuration back to a saved version (the current state is saved as a version first). Changes what live visitors see, so it needs the agents:publish scope and confirm: true. Check diff_versions first.

Side effects

Saves the current state as a version, then brings back the chosen one. Visitors of a published agent see it at once.

Inputs

Example

curl -X POST "https://covo.lanaai.io/api/v1/agents/agt_4edc89bb2964/versions/3/restore" \
  -H "Authorization: Bearer $COVO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"confirm":true}'

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "restore_version",
    "arguments": {
      "agent_id": "agt_4edc89bb2964",
      "version": 3,
      "confirm": true
    }
  }
}

Response

Returns an object with restored, version, revision, changes and backup_version. This is a real response, shortened to two items per list.

{
  "restored": false,
  "version": 3,
  "revision": 7,
  "changes": [],
  "backup_version": null
}

Over MCP the same object comes back as the tool result, in structuredContent and as JSON text.

Errors