Activate a version | Smallest AI Docs

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

{
  "status": true,
  "data": {
    "_id": "60d0fe4f5311236168a109cb",
    "agent": "60d0fe4f5311236168a109ca",
    "status": "published",
    "versionNumber": 3,
    "label": "Q1 2024 Update",
    "description": "Improved NLP accuracy and added new call handling features",
    "isPinned": true,
    "publishedBy": "user_987654321",
    "sourceVersionId": "60d0fe4f5311236168a109c9",
    "blocks": {
      "workflow_prompt": "Initial greeting and intent detection",
      "workflow_tools": "Sentiment analysis, entity extraction",
      "workflow_graph": "Node-based call flow with fallback nodes",
      "llm": "GPT-4",
      "voice": "en-US-Wavenet-D",
      "language": "en-US",
      "call_handling": "Voicemail, call transfer, callback scheduling",
      "detection": "Silence detection, keyword spotting",
      "analytics": "Call duration, sentiment trends",
      "timeouts": "30s max wait, 5s silence timeout",
      "audio": "High-quality 16kHz audio encoding",
      "privacy": "GDPR compliant data handling",
      "widget": "Embedded web chat widget v2.1"
    },
    "workflowType": "workflow_graph",
    "parentVersion": "60d0fe4f5311236168a109c8",
    "isActive": true,
    "createdBy": "user_123456789",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-04-10T14:45:00Z"
  }
}

Set a published version as the active version for the agent. The previously active version is deactivated. This does not modify the version’s config — it only changes which version serves live traffic.

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

Version activated successfully

statusboolean

dataobject

Represents either a draft revision or a published version of an agent's configuration.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error