Get version detail

Deprecated

GET

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

GET

/atoms/v1/agent/:id/versions/:versionId

from smallestai import SmallestAI
client = SmallestAI(
    token="YOUR_TOKEN_HERE",
)
client.atoms.agent_versioning_versions.get_version_detail(
    id="id",
    version_id="versionId",
)

{
  "status": true,
  "data": {
    "version": {
      "_id": "string",
      "agent": "string",
      "status": "published",
      "versionNumber": 1,
      "label": "string",
      "description": "string",
      "isPinned": false,
      "publishedBy": "string",
      "publishedAt": "2024-01-15T09:30:00Z",
      "activatedBy": "string",
      "activatedAt": "2024-01-15T09:30:00Z",
      "draftId": "string",
      "draftName": "string",
      "draftRevision": 1,
      "sourceVersionId": "string",
      "blocks": {
        "workflow_prompt": "string",
        "workflow_tools": "string",
        "workflow_graph": "string",
        "llm": "string",
        "voice": "string",
        "language": "string",
        "call_handling": "string",
        "detection": "string",
        "analytics": "string",
        "timeouts": "string",
        "audio": "string",
        "privacy": "string",
        "widget": "string"
      },
      "workflowType": "workflow_graph",
      "parentVersion": "string",
      "isActive": true,
      "createdBy": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "updatedAt": "2024-01-15T09:30:00Z"
    },
    "resolvedConfig": {}
  }
}

Deprecated. By-id reads are kept working during the v1 coexistence window (~1 month). A v1 versionId equals its migrated revisionId, so this continues to resolve across branches. Migrate to GET /agent/{id}/branches/{branchId}/revisions/{revisionId}. Will be removed at the sunset date.

| Returns the full detail of a specific published version (read-only). Published versions are config-immutable — to modify config, create a draft from this version and publish it as a new version.

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.

versionIdstringRequiredformat: "^[a-f\d]{24}$"

The published version ID

Response

Successful response

statusbooleanOptional

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error