Get revision

GET

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

GET

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

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/agent/id/branches/branchId/revisions/revisionId"
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": "5f8d0d55b54764421b7156c1",
6       "agent": "5f8d0d55b54764421b7156b9",
7       "status": "published",
8       "branch": "5f8d0d55b54764421b7156b5",
9       "revisionNumber": 12,
10       "versionNumber": 34,
11       "label": "Initial Release",
12       "description": "First stable version of the agent configuration.",
13       "isPinned": false,
14       "publishedBy": "user_12345",
15       "publishedAt": "2024-01-15T09:30:00Z",
16       "publishedByName": "Alice Johnson",
17       "restoredFromLabel": null,
18       "draftId": null,
19       "draftName": null,
20       "draftRevision": null,
21       "sourceVersionId": "5f8d0d55b54764421b7156a9",
22       "blocks": {
23         "workflow_prompt": "5f8d0d55b54764421b7156d0",
24         "workflow_tools": "5f8d0d55b54764421b7156d1",
25         "workflow_graph": "5f8d0d55b54764421b7156d2",
26         "llm": "5f8d0d55b54764421b7156d3",
27         "voice": "5f8d0d55b54764421b7156d4",
28         "language": "5f8d0d55b54764421b7156d5",
29         "call_handling": "5f8d0d55b54764421b7156d6",
30         "detection": "5f8d0d55b54764421b7156d7",
31         "analytics": "5f8d0d55b54764421b7156d8",
32         "timeouts": "5f8d0d55b54764421b7156d9",
33         "audio": "5f8d0d55b54764421b7156da",
34         "privacy": "5f8d0d55b54764421b7156db",
35         "widget": "5f8d0d55b54764421b7156dc",
36         "playbooks": "5f8d0d55b54764421b7156dd"
37       },
38       "workflowType": "standard",
39       "parentVersion": "5f8d0d55b54764421b7156a8",
40       "isActive": true,
41       "activatedBy": "user_12345",
42       "activatedAt": "2024-01-15T10:00:00Z",
43       "securityCheck": {
44         "status": "passed",
45         "reason": null,
46         "triggeredAt": "2024-01-15T09:45:00Z",
47         "completedAt": "2024-01-15T09:50: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-01-15T09:55:00Z",
58         "dimensions": [
59           {
60             "tier": 1,
61             "level": "high",
62             "evidence_span": "Prompt section 2",
63             "title": "Relevance",
64             "description": "The prompt is highly relevant to the task."
65           }
66         ]
67       },
68       "promptScoreStale": false,
69       "createdBy": "user_12345",
70       "createdAt": "2024-01-10T08:00:00Z",
71       "updatedAt": "2024-01-15T09:30:00Z"
72     },
73     "resolvedConfig": {
74       "language": "en-US",
75       "voice": "female-1",
76       "timeoutSeconds": 30,
77       "callHandling": {
78         "voicemailEnabled": true,
79         "callRecording": false
80       },
81       "analytics": {
82         "enabled": true,
83         "trackingId": "UA-12345678-9"
84       },
85       "privacy": {
86         "dataRetentionDays": 90,
87         "anonymizeCalls": true
88       },
89       "widget": {
90         "theme": "dark",
91         "position": "bottom-right"
92       },
93       "playbooks": {
94         "enabled": true,
95         "defaultPlaybookId": "playbook_7890"
96       }
97     }
98   }
99 }

Return a single revision plus its resolvedConfig (the fully-merged agent config at that revision).

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