List revisions on a branch

GET

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

GET

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

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/agent/id/branches/branchId/revisions"
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     "revisions": [
5       {
6         "_id": "642f1c3e9a1b2c0012345678",
7         "agent": "642f1c3e9a1b2c001234abcd",
8         "status": "published",
9         "branch": "642f1c3e9a1b2c0098765432",
10         "revisionNumber": 42,
11         "versionNumber": 7,
12         "label": "Initial Release",
13         "description": "First stable published revision of the agent.",
14         "isPinned": false,
15         "publishedBy": "5f8d0d55b54764421b7156c3",
16         "publishedAt": "2024-04-10T14:22:00Z",
17         "publishedByName": "Alice Johnson",
18         "restoredFromLabel": null,
19         "draftId": null,
20         "draftName": null,
21         "draftRevision": null,
22         "sourceVersionId": "5f8d0d55b54764421b7156c3",
23         "blocks": {
24           "workflow_prompt": "642f1c3e9a1b2c00abcdef01",
25           "workflow_tools": "642f1c3e9a1b2c00abcdef02",
26           "workflow_graph": "642f1c3e9a1b2c00abcdef03",
27           "llm": "642f1c3e9a1b2c00abcdef04",
28           "voice": "642f1c3e9a1b2c00abcdef05",
29           "language": "642f1c3e9a1b2c00abcdef06",
30           "call_handling": "642f1c3e9a1b2c00abcdef07",
31           "detection": "642f1c3e9a1b2c00abcdef08",
32           "analytics": "642f1c3e9a1b2c00abcdef09",
33           "timeouts": "642f1c3e9a1b2c00abcdef0a",
34           "audio": "642f1c3e9a1b2c00abcdef0b",
35           "privacy": "642f1c3e9a1b2c00abcdef0c",
36           "widget": "642f1c3e9a1b2c00abcdef0d",
37           "playbooks": "642f1c3e9a1b2c00abcdef0e"
38         },
39         "workflowType": "standard",
40         "parentVersion": "642f1c3e9a1b2c0012345677",
41         "isActive": true,
42         "activatedBy": "5f8d0d55b54764421b7156c3",
43         "activatedAt": "2024-04-10T14:30:00Z",
44         "securityCheck": {
45           "status": "passed",
46           "reason": null,
47           "triggeredAt": "2024-04-10T14:25:00Z",
48           "completedAt": "2024-04-10T14:28:00Z"
49         },
50         "pendingPublish": null,
51         "restoredFromRevisionId": null,
52         "sourceDraftId": null,
53         "promptScore": {
54           "overall_score": 92.5,
55           "overall_grade": "A",
56           "band": "high",
57           "estimated_ttft_overhead_ms": 120.5,
58           "scoredAt": "2024-04-10T14:29:00Z",
59           "dimensions": [
60             {
61               "tier": 1,
62               "level": "excellent",
63               "evidence_span": "workflow_prompt",
64               "title": "Prompt Clarity",
65               "description": "The prompt is clear and concise, leading to accurate responses."
66             }
67           ]
68         },
69         "promptScoreStale": false,
70         "createdBy": "5f8d0d55b54764421b7156c3",
71         "createdAt": "2024-04-09T10:00:00Z",
72         "updatedAt": "2024-04-10T14:30:00Z"
73       }
74     ],
75     "total": 1
76   }
77 }

Paginated list of committed and scanning revisions on this branch, newest first.

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.

Query parameters

limitintegerOptional1-100Defaults to 20

skipintegerOptional>=0Defaults to 0

Response

Successful response.

statusboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error