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 saved and backup versions differ, how many the API can create, and what happens when you restore one.