List published versions

GET

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

GET

/atoms/v1/agent/:id/versions

1 import requests
2 
3 url = "https://api.smallest.ai/atoms/v1/agent/60d0fe4f5311236168a109ca/versions"
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     "versions": [
5       {
6         "_id": "64b8f9a2e4b0c123456789ab",
7         "agent": "60d0fe4f5311236168a109ca",
8         "status": "published",
9         "versionNumber": 3,
10         "label": "Initial Release",
11         "description": "First stable version with core features implemented",
12         "isPinned": true,
13         "publishedBy": "user_987654321",
14         "draftId": null,
15         "draftName": null,
16         "draftRevision": null,
17         "sourceVersionId": null,
18         "blocks": {
19           "workflow_prompt": "prompt_123",
20           "workflow_tools": "tools_456",
21           "workflow_graph": "graph_789",
22           "llm": "llm_v1",
23           "voice": "voice_standard",
24           "language": "en-US",
25           "call_handling": "call_handler_v2",
26           "detection": "detection_module_1",
27           "analytics": "analytics_basic",
28           "timeouts": "timeout_default",
29           "audio": "audio_config_1",
30           "privacy": "privacy_policy_v1",
31           "widget": "widget_standard"
32         },
33         "workflowType": "workflow_graph",
34         "parentVersion": "64b8f9a2e4b0c123456789aa",
35         "isActive": true,
36         "createdBy": "user_123456789",
37         "createdAt": "2024-01-15T09:30:00Z",
38         "updatedAt": "2024-02-10T11:45:00Z",
39         "publishedByName": "Alice Johnson"
40       }
41     ],
42     "total": 1
43   }
44 }

List published versions for an agent with pagination and optional pin filter.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Path parameters

idstringRequired

The agent ID

Query parameters

limitintegerOptional1-100Defaults to 20

Number of versions to return (1-100, default 20)

skipintegerOptional>=0Defaults to 0

Number of versions to skip (default 0)

isPinnedbooleanOptional

Filter by pinned status

Response

Successful response

statusboolean

dataobject

Errors

401

Unauthorized Error

500

Internal Server Error