Diff two versions | Smallest AI Docs

import requests
url = "https://api.smallest.ai/atoms/v1/agent/60d0fe4f5311236168a109ca/versions/diff"
querystring = {"versionA":"5f8d0d55b54764421b7156c1","versionB":"5f8d0d55b54764421b7156c2"}
payload = { "id": "60d0fe4f5311236168a109ca" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.get(url, json=payload, headers=headers, params=querystring)
print(response.json())

{
  "status": true,
  "data": {
    "sections": [
      {
        "sectionName": "Introduction",
        "versionAContent": "Welcome to the agent version 1.0. This version includes basic greeting capabilities.",
        "versionBContent": "Welcome to the agent version 1.1. This version includes enhanced greeting and small talk features.",
        "diff": "- Basic greeting capabilities\n+ Enhanced greeting and small talk features"
      },
      {
        "sectionName": "Capabilities",
        "versionAContent": "Handles FAQs and simple commands.",
        "versionBContent": "Handles FAQs, simple commands, and integrates with calendar APIs.",
        "diff": "+ Integration with calendar APIs"
      }
    ]
  }
}

Compare two published versions side-by-side by their IDs.

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

Query parameters

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

ID of the first version

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

ID of the second version

Response

Diff returned successfully

statusboolean

dataobject

Section-by-section diff between the two versions

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error