List published versions

Deprecated

GET

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

GET

/atoms/v1/agent/:id/versions

1 from smallestai import SmallestAI
2 
3 client = SmallestAI(
4     token="YOUR_TOKEN_HERE",
5 )
6 
7 client.atoms.agent_versioning_versions.list_published_versions(
8     id="id",
9 )

1 {
2   "status": true,
3   "data": {
4     "versions": [
5       {
6         "_id": "63f1a2b4e4b0c123456789ab",
7         "agent": "63f1a2b4e4b0c123456789ac",
8         "status": "published",
9         "versionNumber": 3,
10         "label": "Release 3.0 - Improved NLP",
11         "description": "Enhanced natural language processing and bug fixes in call handling.",
12         "isPinned": true,
13         "publishedBy": "5f8d0d55b54764421b7156c3",
14         "publishedAt": "2024-01-15T09:30:00Z",
15         "activatedBy": "5f8d0d55b54764421b7156c3",
16         "activatedAt": "2024-01-15T09:45:00Z",
17         "draftId": null,
18         "draftName": null,
19         "draftRevision": null,
20         "sourceVersionId": "63f1a2b4e4b0c123456789aa",
21         "blocks": {
22           "workflow_prompt": "63f1a2b4e4b0c123456789ad",
23           "workflow_tools": "63f1a2b4e4b0c123456789ae",
24           "workflow_graph": "63f1a2b4e4b0c123456789af",
25           "llm": "63f1a2b4e4b0c123456789b0",
26           "voice": "63f1a2b4e4b0c123456789b1",
27           "language": "63f1a2b4e4b0c123456789b2",
28           "call_handling": "63f1a2b4e4b0c123456789b3",
29           "detection": "63f1a2b4e4b0c123456789b4",
30           "analytics": "63f1a2b4e4b0c123456789b5",
31           "timeouts": "63f1a2b4e4b0c123456789b6",
32           "audio": "63f1a2b4e4b0c123456789b7",
33           "privacy": "63f1a2b4e4b0c123456789b8",
34           "widget": "63f1a2b4e4b0c123456789b9"
35         },
36         "workflowType": "workflow_graph",
37         "parentVersion": "63f1a2b4e4b0c123456789aa",
38         "isActive": true,
39         "createdBy": "5f8d0d55b54764421b7156c3",
40         "createdAt": "2023-12-20T08:00:00Z",
41         "updatedAt": "2024-01-15T09:00:00Z",
42         "publishedByName": "Alice Johnson",
43         "activatedByName": "Alice Johnson"
44       }
45     ],
46     "total": 5
47   }
48 }

Deprecated on the v2 branch model. Migrate to GET /agent/{id}/branches/{branchId}/revisions. When ENABLE_BRANCH_MODEL is on, this endpoint returns 409 versioning_v2_migration_required with the Deprecation: true header. See the migration guide.

| List published versions for an agent with pagination and optional pin filter. The total value currently represents the total number of published versions for the agent, not necessarily the filtered count when isPinned is used.

**Deprecated on the v2 branch model.** Migrate to `GET /agent/{id}/branches/{branchId}/revisions`. When `ENABLE_BRANCH_MODEL` is on, this endpoint returns `409 versioning_v2_migration_required` with the `Deprecation: true` header. See the [migration guide](/voice-agents/deprecations/agent-versioning-migration). | List published versions for an agent with pagination and optional pin filter. The `total` value currently represents the total number of published versions for the agent, not necessarily the filtered count when `isPinned` is used.

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.

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

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error