MCP is live.Set up
OmniDimension
Dashboard
DocumentationAPI referenceSDKsMCPTutorials
Agents

List agent versions

List an agent's saved versions, newest first. Includes manual (named) versions, automatic versions, and system backups taken before a restore.

GET/agents//versions
Path parameters
agent_idrequired
Query parameters
pagenointeger

Page number for pagination.

pagesizeinteger

Number of items per page (max 150).

searchstring

Filter versions whose name matches this substring (case-insensitive).

kindstring · enum

Filter versions by kind.

curl -X GET 'https://backend.omnidim.io/api/v1/agents/{agent_id}/versions?pageno=1&pagesize=30' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Example response
{
  "versions": [
    {
      "id": 4821,
      "version_number": 5,
      "name": "Working pricing script",
      "note": "Before the new discount flow",
      "kind": "manual",
      "created_by": {
        "id": 1234,
        "name": "Demo User"
      },
      "create_date": "2026-07-20T10:15:00Z",
      "summary": {
        "llm_service": "gpt-4.1-mini",
        "voice_name": "asteria",
        "bot_type": "prompt",
        "languages": [
          "English"
        ],
        "context_sections": 7,
        "transfer_options": 1,
        "post_call_configs": 1,
        "knowledge_files": 2,
        "integrations": 0,
        "flow_nodes": 0
      }
    },
    {
      "id": 4809,
      "version_number": 4,
      "name": "Auto-saved",
      "note": "",
      "kind": "auto",
      "created_by": {
        "id": 1234,
        "name": "Demo User"
      },
      "create_date": "2026-07-18T09:02:00Z",
      "summary": {
        "llm_service": "gpt-4.1-mini",
        "voice_name": "asteria",
        "bot_type": "prompt",
        "languages": [
          "English"
        ],
        "context_sections": 6,
        "transfer_options": 1,
        "post_call_configs": 1,
        "knowledge_files": 2,
        "integrations": 0,
        "flow_nodes": 0
      }
    }
  ],
  "total_count": 5,
  "counts": {
    "all": 5,
    "manual": 2,
    "auto": 2,
    "system": 1
  },
  "page": 1,
  "page_size": 30,
  "version_history_enabled": true
}

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.

Query Parameters

pageno?integer

Page number for pagination.

Default1
pagesize?integer

Number of items per page (max 150).

Default30
Rangevalue <= 150
search?string

Filter versions whose name matches this substring (case-insensitive).

kind?string

Filter versions by kind.

Value in"manual" | "auto" | "system"

Response Body

application/json

application/json

application/json

Update agent

Update an existing agent. Send only the fields you want to change. > **Voicemail detection is an access-gated feature** that we turn on per account. If it isn't enabled for yours yet, [request access](https://omnidim.io/contact-us?reason=product&lock=1) before configuring the `voicemail` object below.

Save an agent version

Save the agent's current configuration as a named version.