Get revision publish trail

GET

https://api.smallest.ai/atoms/v1/agent/:id/branches/:branchId/revisions/:revisionId/history

GET

/atoms/v1/agent/:id/branches/:branchId/revisions/:revisionId/history

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/agent/id/branches/branchId/revisions/revisionId/history"
4 
5 payload = {}
6 headers = {
7     "Authorization": "Bearer <token>",
8     "Content-Type": "application/json"
9 }
10 
11 response = requests.get(url, json=payload, headers=headers)
12 
13 print(response.json())

1 {
2   "status": true,
3   "data": {
4     "revision": {
5       "_id": "64b8f9a2e4b0c123456789ab",
6       "agent": "64b8f9a2e4b0c123456789ac",
7       "status": "published",
8       "branch": "64b8f9a2e4b0c123456789ad",
9       "revisionNumber": 5,
10       "versionNumber": 42,
11       "label": "Release 1.4.0",
12       "description": "Added new voice commands and improved detection accuracy.",
13       "isPinned": false,
14       "publishedBy": "user_987654321",
15       "publishedAt": "2024-04-10T14:22:00Z",
16       "publishedByName": "Alice Johnson",
17       "restoredFromLabel": null,
18       "draftId": null,
19       "draftName": null,
20       "draftRevision": null,
21       "sourceVersionId": null,
22       "blocks": {
23         "workflow_prompt": "64b8f9a2e4b0c123456789ae",
24         "workflow_tools": "64b8f9a2e4b0c123456789af",
25         "workflow_graph": "64b8f9a2e4b0c123456789b0",
26         "llm": "64b8f9a2e4b0c123456789b1",
27         "voice": "64b8f9a2e4b0c123456789b2",
28         "language": "64b8f9a2e4b0c123456789b3",
29         "call_handling": "64b8f9a2e4b0c123456789b4",
30         "detection": "64b8f9a2e4b0c123456789b5",
31         "analytics": "64b8f9a2e4b0c123456789b6",
32         "timeouts": "64b8f9a2e4b0c123456789b7",
33         "audio": "64b8f9a2e4b0c123456789b8",
34         "privacy": "64b8f9a2e4b0c123456789b9",
35         "widget": "64b8f9a2e4b0c123456789ba",
36         "playbooks": "64b8f9a2e4b0c123456789bb"
37       },
38       "workflowType": "standard",
39       "parentVersion": "64b8f9a2e4b0c123456789b9",
40       "isActive": true,
41       "activatedBy": "user_987654321",
42       "activatedAt": "2024-04-10T14:30:00Z",
43       "securityCheck": {
44         "status": "passed",
45         "reason": null,
46         "triggeredAt": "2024-04-10T14:00:00Z",
47         "completedAt": "2024-04-10T14:15:00Z"
48       },
49       "pendingPublish": null,
50       "restoredFromRevisionId": null,
51       "sourceDraftId": null,
52       "promptScore": {
53         "overall_score": 92.5,
54         "overall_grade": "A",
55         "band": "high",
56         "estimated_ttft_overhead_ms": 120.5,
57         "scoredAt": "2024-04-10T14:20:00Z",
58         "dimensions": [
59           {
60             "tier": 1,
61             "level": "high",
62             "evidence_span": "workflow_prompt",
63             "title": "Prompt Clarity",
64             "description": "The prompt is clear and concise, leading to better model responses."
65           }
66         ]
67       },
68       "promptScoreStale": false,
69       "createdBy": "user_123456789",
70       "createdAt": "2024-04-09T10:00:00Z",
71       "updatedAt": "2024-04-10T14:22:00Z"
72     },
73     "publishedBy": "Alice Johnson",
74     "trail": [
75       {
76         "revision": {
77           "_id": "64b8f9a2e4b0c123456789a1",
78           "agent": "64b8f9a2e4b0c123456789ac",
79           "status": "published",
80           "branch": "64b8f9a2e4b0c123456789ad",
81           "revisionNumber": 4,
82           "versionNumber": 41,
83           "label": "Release 1.3.5",
84           "description": "Fixed bugs in call handling and improved analytics.",
85           "isPinned": false,
86           "publishedBy": "user_876543210",
87           "publishedAt": "2024-03-20T11:00:00Z",
88           "publishedByName": "Bob Smith",
89           "restoredFromLabel": null,
90           "draftId": null,
91           "draftName": null,
92           "draftRevision": null,
93           "sourceVersionId": null,
94           "blocks": {
95             "workflow_prompt": "64b8f9a2e4b0c123456789a2",
96             "workflow_tools": "64b8f9a2e4b0c123456789a3",
97             "workflow_graph": "64b8f9a2e4b0c123456789a4",
98             "llm": "64b8f9a2e4b0c123456789a5",
99             "voice": "64b8f9a2e4b0c123456789a6",
100             "language": "64b8f9a2e4b0c123456789a7",
101             "call_handling": "64b8f9a2e4b0c123456789a8",
102             "detection": "64b8f9a2e4b0c123456789a9",
103             "analytics": "64b8f9a2e4b0c123456789aa",
104             "timeouts": "64b8f9a2e4b0c123456789ab",
105             "audio": "64b8f9a2e4b0c123456789ac",
106             "privacy": "64b8f9a2e4b0c123456789ad",
107             "widget": "64b8f9a2e4b0c123456789ae",
108             "playbooks": "64b8f9a2e4b0c123456789af"
109           },
110           "workflowType": "standard",
111           "parentVersion": "64b8f9a2e4b0c123456789a0",
112           "isActive": false,
113           "activatedBy": "user_876543210",
114           "activatedAt": "2024-03-20T11:10:00Z",
115           "securityCheck": {
116             "status": "passed",
117             "reason": null,
118             "triggeredAt": "2024-03-20T10:45:00Z",
119             "completedAt": "2024-03-20T10:55:00Z"
120           },
121           "pendingPublish": null,
122           "restoredFromRevisionId": null,
123           "sourceDraftId": null,
124           "promptScore": {
125             "overall_score": 88.3,
126             "overall_grade": "B+",
127             "band": "medium",
128             "estimated_ttft_overhead_ms": 130,
129             "scoredAt": "2024-03-20T10:50:00Z",
130             "dimensions": [
131               {
132                 "tier": 2,
133                 "level": "medium",
134                 "evidence_span": "call_handling",
135                 "title": "Call Handling Efficiency",
136                 "description": "Improved call routing logic."
137               }
138             ]
139           },
140           "promptScoreStale": false,
141           "createdBy": "user_876543210",
142           "createdAt": "2024-03-19T09:00:00Z",
143           "updatedAt": "2024-03-20T11:00:00Z"
144         },
145         "changedSections": [
146           "call_handling",
147           "analytics"
148         ]
149       },
150       {
151         "revision": {
152           "_id": "64b8f9a2e4b0c12345678990",
153           "agent": "64b8f9a2e4b0c123456789ac",
154           "status": "published",
155           "branch": "64b8f9a2e4b0c123456789ad",
156           "revisionNumber": 3,
157           "versionNumber": 40,
158           "label": "Release 1.3.0",
159           "description": "Initial release with basic voice and language support.",
160           "isPinned": false,
161           "publishedBy": "user_765432109",
162           "publishedAt": "2024-02-15T08:00:00Z",
163           "publishedByName": "Carol Lee",
164           "restoredFromLabel": null,
165           "draftId": null,
166           "draftName": null,
167           "draftRevision": null,
168           "sourceVersionId": null,
169           "blocks": {
170             "workflow_prompt": "64b8f9a2e4b0c12345678991",
171             "workflow_tools": "64b8f9a2e4b0c12345678992",
172             "workflow_graph": "64b8f9a2e4b0c12345678993",
173             "llm": "64b8f9a2e4b0c12345678994",
174             "voice": "64b8f9a2e4b0c12345678995",
175             "language": "64b8f9a2e4b0c12345678996",
176             "call_handling": "64b8f9a2e4b0c12345678997",
177             "detection": "64b8f9a2e4b0c12345678998",
178             "analytics": "64b8f9a2e4b0c12345678999",
179             "timeouts": "64b8f9a2e4b0c1234567899a",
180             "audio": "64b8f9a2e4b0c1234567899b",
181             "privacy": "64b8f9a2e4b0c1234567899c",
182             "widget": "64b8f9a2e4b0c1234567899d",
183             "playbooks": "64b8f9a2e4b0c1234567899e"
184           },
185           "workflowType": "standard",
186           "parentVersion": null,
187           "isActive": false,
188           "activatedBy": "user_765432109",
189           "activatedAt": "2024-02-15T08:10:00Z",
190           "securityCheck": {
191             "status": "passed",
192             "reason": null,
193             "triggeredAt": "2024-02-15T07:45:00Z",
194             "completedAt": "2024-02-15T07:55:00Z"
195           },
196           "pendingPublish": null,
197           "restoredFromRevisionId": null,
198           "sourceDraftId": null,
199           "promptScore": {
200             "overall_score": 85,
201             "overall_grade": "B",
202             "band": "medium",
203             "estimated_ttft_overhead_ms": 140,
204             "scoredAt": "2024-02-15T07:50:00Z",
205             "dimensions": [
206               {
207                 "tier": 2,
208                 "level": "medium",
209                 "evidence_span": "voice",
210                 "title": "Voice Recognition",
211                 "description": "Basic voice recognition implemented."
212               }
213             ]
214           },
215           "promptScoreStale": false,
216           "createdBy": "user_765432109",
217           "createdAt": "2024-02-14T07:00:00Z",
218           "updatedAt": "2024-02-15T08:00:00Z"
219         },
220         "changedSections": [
221           "voice",
222           "language"
223         ]
224       }
225     ]
226   }
227 }

Return the publish trail for a revision: who published it, and the ordered list of prior revisions on this branch with the sections that changed at each step.

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.

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

The branch ID.

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

The revision ID. Equal to the v1 versionId for revisions that were migrated from the v1 model.

Response

Successful response.

statusboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error