Get version detail

Deprecated

GET

https://api.smallest.ai/atoms/v1/agent/:id/versions/:versionId

GET

/atoms/v1/agent/:id/versions/:versionId

1 from smallestai import SmallestAI
2 
3 client = SmallestAI(
4     token="YOUR_TOKEN_HERE",
5 )
6 
7 client.atoms.agent_versioning_versions.get_version_detail(
8     id="id",
9     version_id="versionId",
10 )

1 {
2   "status": true,
3   "data": {
4     "version": {
5       "_id": "5f8d0d55b54764421b7156c3",
6       "agent": "5f8d0d55b54764421b7156a9",
7       "status": "published",
8       "versionNumber": 3,
9       "label": "Initial Release v3",
10       "description": "Added new call handling logic and updated voice prompts.",
11       "isPinned": true,
12       "publishedBy": "user_12345",
13       "publishedAt": "2024-01-15T09:30:00Z",
14       "activatedBy": "user_12345",
15       "activatedAt": "2024-01-15T09:30:00Z",
16       "draftId": null,
17       "draftName": null,
18       "draftRevision": null,
19       "sourceVersionId": "5f8d0d55b54764421b7156c1",
20       "blocks": {
21         "workflow_prompt": "prompt_block_001",
22         "workflow_tools": "tools_block_001",
23         "workflow_graph": "graph_block_001",
24         "llm": "llm_block_001",
25         "voice": "voice_block_001",
26         "language": "language_block_001",
27         "call_handling": "call_handling_block_001",
28         "detection": "detection_block_001",
29         "analytics": "analytics_block_001",
30         "timeouts": "timeouts_block_001",
31         "audio": "audio_block_001",
32         "privacy": "privacy_block_001",
33         "widget": "widget_block_001"
34       },
35       "workflowType": "workflow_graph",
36       "parentVersion": "5f8d0d55b54764421b7156c2",
37       "isActive": true,
38       "createdBy": "user_12345",
39       "createdAt": "2024-01-10T08:00:00Z",
40       "updatedAt": "2024-01-15T09:30:00Z"
41     },
42     "resolvedConfig": {
43       "workflow_prompt": {
44         "welcomeMessage": "Hello! How can I assist you today?"
45       },
46       "workflow_tools": {
47         "toolA": "enabled",
48         "toolB": "disabled"
49       },
50       "workflow_graph": {
51         "nodes": 12,
52         "edges": 15
53       },
54       "llm": {
55         "model": "gpt-4",
56         "temperature": 0.7
57       },
58       "voice": {
59         "language": "en-US",
60         "voiceName": "Joanna"
61       },
62       "language": {
63         "default": "en",
64         "supported": [
65           "en",
66           "es",
67           "fr"
68         ]
69       },
70       "call_handling": {
71         "maxCallDuration": 3600,
72         "voicemailEnabled": true
73       },
74       "detection": {
75         "speechRecognition": "enabled",
76         "intentDetection": "enabled"
77       },
78       "analytics": {
79         "trackingId": "UA-12345678-9"
80       },
81       "timeouts": {
82         "responseTimeout": 30,
83         "callTimeout": 300
84       },
85       "audio": {
86         "bitrate": 128,
87         "format": "mp3"
88       },
89       "privacy": {
90         "dataRetentionDays": 90,
91         "encryption": "AES-256"
92       },
93       "widget": {
94         "enabled": true,
95         "theme": "dark"
96       }
97     }
98   }
99 }

Deprecated. By-id reads are kept working during the v1 coexistence window (~1 month). A v1 versionId equals its migrated revisionId, so this continues to resolve across branches. Migrate to GET /agent/{id}/branches/{branchId}/revisions/{revisionId}. Will be removed at the sunset date.

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

**Deprecated.** By-id reads are kept working during the v1 coexistence window (~1 month). A v1 `versionId` equals its migrated `revisionId`, so this continues to resolve across branches. Migrate to `GET /agent/{id}/branches/{branchId}/revisions/{revisionId}`. Will be removed at the sunset date. | 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

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

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

403

Forbidden Error

404

Not Found Error

500

Internal Server Error