MCP is live.Set up
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCPTutorials
Agents

Restore an agent version

Restore a version onto the live agent. Your current setup is saved first as a backup version, so restoring is undoable. Configuration is brought back; any knowledge files or integrations that were deleted since this version was saved can't be re-linked, and are reported in `skipped`.

POST/agents//versions//restore
Path parameters
agent_idrequired
version_numberrequired
curl -X POST 'https://backend.omnidim.io/api/v1/agents/{agent_id}/versions/{version_number}/restore' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example response
{
  "success": true,
  "restored_from": 5,
  "safety_version": 7,
  "skipped": [
    {
      "item": "knowledge_file",
      "label": "old-pricing-sheet.pdf",
      "reason": "deleted"
    }
  ]
}

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token authentication. Obtain your API key from the OmniDimension dashboard.

In: header

Path Parameters

agent_id*integer

The ID of the agent.

version_number*integer

The version number, as returned in version_number from the list or save endpoints.

Response Body

application/json

application/json

application/json

Diff an agent version

Get a record-level diff for this version. By default it shows what changed in this version compared with the version before it. Use `against=current` to compare with the agent's live config (what restoring this version would change), or `against=<number>` to compare with another version.

Agent version history

What agent version history is, how manual, auto-saved, and backup versions differ, and what happens when you restore one.