Get version detail | Smallest AI Docs

import requests
url = "https://api.smallest.ai/atoms/v1/agent/60d0fe4f5311236168a109ca/versions/versionId"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers)
print(response.json())

{
  "status": true,
  "data": {
    "version": {
      "_id": "60d1fe4f5311236168a109cb",
      "agent": "60d0fe4f5311236168a109ca",
      "status": "published",
      "versionNumber": 3,
      "label": "Q1 2024 Customer Support Update",
      "description": "Improved call routing and updated language model for better response accuracy.",
      "isPinned": true,
      "publishedBy": "user_987654321",
      "draftId": null,
      "draftName": null,
      "draftRevision": null,
      "sourceVersionId": "60d1fe4f5311236168a109c9",
      "blocks": {
        "workflow_prompt": "Initial greeting and verification prompts updated.",
        "workflow_tools": "Integrated new sentiment analysis tool v2.1.",
        "workflow_graph": "Updated node connections for fallback handling.",
        "llm": "GPT-4-turbo",
        "voice": "en-US-Wavenet-D",
        "language": "en-US",
        "call_handling": "Enhanced IVR with dynamic routing.",
        "detection": "Background noise detection enabled.",
        "analytics": "Added call duration and sentiment metrics.",
        "timeouts": "Set max wait time to 30 seconds.",
        "audio": "High-quality audio codec enabled.",
        "privacy": "GDPR compliance enabled with data masking.",
        "widget": "Updated chat widget with new UI."
      },
      "workflowType": "workflow_graph",
      "parentVersion": "60d1fe4f5311236168a109c8",
      "isActive": true,
      "createdBy": "user_987654321",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-02-10T14:45:00Z"
    }
  }
}

Returns the full detail of a specific published version (read-only). Published versions are config-immutable — to modify config, create a draft from this version and publish it as a new version.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired

The agent ID

versionIdstringRequiredformat: "^[a-f\d]{24}$"

The published version ID

Response

Successful response

statusboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error