Get open draft

GET

https://api.smallest.ai/atoms/v1/agent/:id/branches/:branchId/draft

GET

/atoms/v1/agent/:id/branches/:branchId/draft

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/agent/id/branches/branchId/draft"
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     "latest": {
5       "_id": "64b8f9a2e4b0c123456789ab",
6       "agent": "64b8f9a2e4b0c123456789ac",
7       "status": "draft",
8       "branch": "64b8f9a2e4b0c123456789ad",
9       "revisionNumber": null,
10       "versionNumber": null,
11       "label": null,
12       "description": "Initial draft for new customer support workflow",
13       "isPinned": false,
14       "publishedBy": null,
15       "publishedAt": null,
16       "publishedByName": null,
17       "restoredFromLabel": null,
18       "draftId": "draft_00123",
19       "draftName": "Customer Support Workflow Draft",
20       "draftRevision": 3,
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": "customer_support",
39       "parentVersion": null,
40       "isActive": false,
41       "activatedBy": null,
42       "activatedAt": null,
43       "securityCheck": null,
44       "pendingPublish": {
45         "state": "active",
46         "startedBy": "user_98765",
47         "startedAt": "2024-04-20T14:45:00Z"
48       },
49       "restoredFromRevisionId": null,
50       "sourceDraftId": null,
51       "promptScore": {
52         "overall_score": 87.5,
53         "overall_grade": "B+",
54         "band": "medium",
55         "estimated_ttft_overhead_ms": 120.5,
56         "scoredAt": "2024-04-20T14:40:00Z",
57         "dimensions": [
58           {
59             "tier": 2,
60             "level": "moderate",
61             "evidence_span": "Prompt section 3",
62             "title": "Clarity",
63             "description": "The prompt is mostly clear but could be simplified."
64           }
65         ]
66       },
67       "promptScoreStale": false,
68       "createdBy": "user_12345",
69       "createdAt": "2024-04-18T10:00:00Z",
70       "updatedAt": "2024-04-20T14:50:00Z"
71     },
72     "editCount": 3,
73     "editHistory": [
74       {
75         "revision": {
76           "_id": "64b8f9a2e4b0c123456789ac",
77           "agent": "64b8f9a2e4b0c123456789ac",
78           "status": "draft",
79           "branch": "64b8f9a2e4b0c123456789ad",
80           "revisionNumber": null,
81           "versionNumber": null,
82           "label": null,
83           "description": "Added new call handling logic",
84           "isPinned": false,
85           "publishedBy": null,
86           "publishedAt": null,
87           "publishedByName": null,
88           "restoredFromLabel": null,
89           "draftId": "draft_00123",
90           "draftName": "Customer Support Workflow Draft",
91           "draftRevision": 2,
92           "sourceVersionId": null,
93           "blocks": {
94             "workflow_prompt": "64b8f9a2e4b0c123456789ae",
95             "workflow_tools": "64b8f9a2e4b0c123456789af",
96             "workflow_graph": "64b8f9a2e4b0c123456789b0",
97             "llm": "64b8f9a2e4b0c123456789b1",
98             "voice": "64b8f9a2e4b0c123456789b2",
99             "language": "64b8f9a2e4b0c123456789b3",
100             "call_handling": "64b8f9a2e4b0c123456789b4",
101             "detection": "64b8f9a2e4b0c123456789b5",
102             "analytics": "64b8f9a2e4b0c123456789b6",
103             "timeouts": "64b8f9a2e4b0c123456789b7",
104             "audio": "64b8f9a2e4b0c123456789b8",
105             "privacy": "64b8f9a2e4b0c123456789b9",
106             "widget": "64b8f9a2e4b0c123456789ba",
107             "playbooks": "64b8f9a2e4b0c123456789bb"
108           },
109           "workflowType": "customer_support",
110           "parentVersion": null,
111           "isActive": false,
112           "activatedBy": null,
113           "activatedAt": null,
114           "securityCheck": null,
115           "pendingPublish": null,
116           "restoredFromRevisionId": null,
117           "sourceDraftId": null,
118           "promptScore": null,
119           "promptScoreStale": false,
120           "createdBy": "user_12345",
121           "createdAt": "2024-04-19T09:00:00Z",
122           "updatedAt": "2024-04-19T09:30:00Z"
123         },
124         "changedSections": [
125           "call_handling",
126           "workflow_prompt"
127         ],
128         "editorName": "Alice Johnson"
129       },
130       {
131         "revision": {
132           "_id": "64b8f9a2e4b0c123456789ab",
133           "agent": "64b8f9a2e4b0c123456789ac",
134           "status": "draft",
135           "branch": "64b8f9a2e4b0c123456789ad",
136           "revisionNumber": null,
137           "versionNumber": null,
138           "label": null,
139           "description": "Initial draft for new customer support workflow",
140           "isPinned": false,
141           "publishedBy": null,
142           "publishedAt": null,
143           "publishedByName": null,
144           "restoredFromLabel": null,
145           "draftId": "draft_00123",
146           "draftName": "Customer Support Workflow Draft",
147           "draftRevision": 1,
148           "sourceVersionId": null,
149           "blocks": {
150             "workflow_prompt": "64b8f9a2e4b0c123456789ae",
151             "workflow_tools": "64b8f9a2e4b0c123456789af",
152             "workflow_graph": "64b8f9a2e4b0c123456789b0",
153             "llm": "64b8f9a2e4b0c123456789b1",
154             "voice": "64b8f9a2e4b0c123456789b2",
155             "language": "64b8f9a2e4b0c123456789b3",
156             "call_handling": "64b8f9a2e4b0c123456789b4",
157             "detection": "64b8f9a2e4b0c123456789b5",
158             "analytics": "64b8f9a2e4b0c123456789b6",
159             "timeouts": "64b8f9a2e4b0c123456789b7",
160             "audio": "64b8f9a2e4b0c123456789b8",
161             "privacy": "64b8f9a2e4b0c123456789b9",
162             "widget": "64b8f9a2e4b0c123456789ba",
163             "playbooks": "64b8f9a2e4b0c123456789bb"
164           },
165           "workflowType": "customer_support",
166           "parentVersion": null,
167           "isActive": false,
168           "activatedBy": null,
169           "activatedAt": null,
170           "securityCheck": null,
171           "pendingPublish": null,
172           "restoredFromRevisionId": null,
173           "sourceDraftId": null,
174           "promptScore": null,
175           "promptScoreStale": false,
176           "createdBy": "user_12345",
177           "createdAt": "2024-04-18T10:00:00Z",
178           "updatedAt": "2024-04-18T10:00:00Z"
179         },
180         "changedSections": [
181           "workflow_prompt"
182         ],
183         "editorName": "Alice Johnson"
184       }
185     ]
186   }
187 }

Return the currently-open draft on this branch, including per-edit history.

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.

Response

Successful response.

statusboolean

dataobject

Returned by GET /agent/{id}/branches/{branchId}/draft.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error