List branches

GET

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

GET

/atoms/v1/agent/:id/branches

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/agent/id/branches"
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     "branches": [
5       {
6         "branch": {
7           "_id": "641f1c3e9a1b2c3d4e5f6789",
8           "agent": "5f8d0d55b54764421b7156c3",
9           "name": "main",
10           "isDefault": true,
11           "sourceBranchId": null,
12           "sourceRevisionId": null,
13           "headRevisionId": "641f1c4a9a1b2c3d4e5f6790",
14           "openDraftId": "641f1c5b9a1b2c3d4e5f6791",
15           "status": "active",
16           "createdBy": "user_12345",
17           "updatedBy": "user_12345",
18           "createdAt": "2024-01-15T09:30:00Z",
19           "updatedAt": "2024-04-10T14:45:00Z"
20         },
21         "isLive": true,
22         "hasOpenDraft": true,
23         "revisionsCount": 12,
24         "headRevisionNumber": 12
25       },
26       {
27         "branch": {
28           "_id": "642a2d4f8b2c4d5e6f7a8901",
29           "agent": "5f8d0d55b54764421b7156c3",
30           "name": "feature/chatbot-improvements",
31           "isDefault": false,
32           "sourceBranchId": "641f1c3e9a1b2c3d4e5f6789",
33           "sourceRevisionId": "641f1c4a9a1b2c3d4e5f6790",
34           "headRevisionId": "642a2d5a8b2c4d5e6f7a8902",
35           "openDraftId": null,
36           "status": "active",
37           "createdBy": "user_67890",
38           "updatedBy": "user_67890",
39           "createdAt": "2024-03-20T11:15:00Z",
40           "updatedAt": "2024-04-05T16:00:00Z"
41         },
42         "isLive": false,
43         "hasOpenDraft": false,
44         "revisionsCount": 5,
45         "headRevisionNumber": 5
46       }
47     ]
48   }
49 }

List all non-archived branches for an agent, with per-branch draft and revision counts.

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.

Response

Successful response.

statusboolean

dataobject

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error