Get draft detail

Deprecated

GET

https://api.smallest.ai/atoms/v1/agent/:id/drafts/:draftId

GET

/atoms/v1/agent/:id/drafts/:draftId

1 from smallestai import SmallestAI
2 
3 client = SmallestAI(
4     token="YOUR_TOKEN_HERE",
5 )
6 
7 client.atoms.agent_versioning_drafts.get_draft_detail(
8     id="id",
9     draft_id="draftId",
10 )

1 {
2   "status": true,
3   "data": {
4     "latest": {
5       "_id": "5f8d0d55b54764421b7156c3",
6       "agent": "5f8d0d55b54764421b7156a9",
7       "status": "draft",
8       "versionNumber": null,
9       "label": "Initial draft for customer support bot",
10       "description": "Added greeting and fallback intents",
11       "isPinned": false,
12       "publishedBy": null,
13       "publishedAt": null,
14       "activatedBy": null,
15       "activatedAt": null,
16       "draftId": "draft-20240426-001",
17       "draftName": "Customer Support Bot Draft",
18       "draftRevision": 3,
19       "sourceVersionId": "5f8d0d55b54764421b7156b0",
20       "blocks": {
21         "workflow_prompt": "prompt_v1",
22         "workflow_tools": "tools_v2",
23         "workflow_graph": "graph_v3",
24         "llm": "gpt-4",
25         "voice": "en-US-Wavenet-D",
26         "language": "en-US",
27         "call_handling": "standard_routing",
28         "detection": "keyword_spotting",
29         "analytics": "basic_metrics",
30         "timeouts": "default_timeouts",
31         "audio": "stereo_44khz",
32         "privacy": "gdpr_compliant",
33         "widget": "chat_widget_v1"
34       },
35       "workflowType": "workflow_graph",
36       "parentVersion": "5f8d0d55b54764421b7156b1",
37       "isActive": false,
38       "createdBy": "user-12345",
39       "createdAt": "2024-04-20T14:22:00Z",
40       "updatedAt": "2024-04-25T16:45:00Z"
41     },
42     "editHistory": [
43       {
44         "revision": 1,
45         "changedSections": [
46           "workflow_prompt",
47           "llm"
48         ],
49         "editorName": "Alice Johnson",
50         "editorId": "user-12345",
51         "timestamp": "2024-04-20T14:22:00Z"
52       },
53       {
54         "revision": 2,
55         "changedSections": [
56           "workflow_tools",
57           "voice"
58         ],
59         "editorName": "Bob Smith",
60         "editorId": "user-67890",
61         "timestamp": "2024-04-23T10:15:00Z"
62       },
63       {
64         "revision": 3,
65         "changedSections": [
66           "workflow_graph",
67           "privacy"
68         ],
69         "editorName": "Alice Johnson",
70         "editorId": "user-12345",
71         "timestamp": "2024-04-25T16:45:00Z"
72       }
73     ],
74     "editCount": 3
75   }
76 }

Deprecated. By-id reads are kept working during the v1 coexistence window (~1 month). A v1 draftId remains resolvable. Migrate to GET /agent/{id}/branches/{branchId}/draft. Will be removed at the sunset date.

Returns the latest revision of a draft along with its 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.

draftIdstringRequired

The draft ID

Query parameters

limitintegerOptional1-100

Max number of edit history entries to return (1-100)

Response

Successful response

statusboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error