MCP is live.Set up
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCPTutorials
Agents

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.

GET/agents//versions//diff
Path parameters
agent_idrequired
version_numberrequired
Query parameters
againststring

What to compare against. Omit or `previous` for the version before this one (the default). `current` for the agent's live config. A version number to compare with that version.

curl -X GET 'https://backend.omnidim.io/api/v1/agents/{agent_id}/versions/{version_number}/diff' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example response
{
  "changed": true,
  "first": false,
  "from": {
    "version_number": 4,
    "name": "Before pricing tweak"
  },
  "to": {
    "version_number": 5,
    "name": "Working pricing script"
  },
  "groups": [
    {
      "area": "Settings",
      "changes": [
        {
          "field": "llm_service",
          "label": "Model",
          "old": "gpt-4.1-mini",
          "new": "gpt-4o-mini"
        }
      ]
    },
    {
      "area": "Knowledge",
      "records": [
        {
          "op": "added",
          "label": "pricing-sheet.pdf"
        }
      ]
    }
  ]
}

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.

Query Parameters

against?string

What to compare against. Omit or previous for the version before this one (the default). current for the agent's live config. A version number to compare with that version.

Response Body

application/json

application/json

application/json

Delete an agent version

Delete a saved version.

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`.