Create a draft | Smallest AI Docs

import requests
url = "https://api.smallest.ai/atoms/v1/agent/60d0fe4f5311236168a109ca/drafts"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "status": true,
  "data": {
    "_id": "60d0fe4f5311236168a109cb",
    "agent": "60d0fe4f5311236168a109ca",
    "status": "draft",
    "versionNumber": 3,
    "label": "Q2 Customer Support Update",
    "description": "Added new fallback responses and updated call handling logic.",
    "isPinned": false,
    "publishedBy": "user_789",
    "draftId": "draft_456",
    "draftName": "Support Bot Q2 Draft",
    "draftRevision": 2,
    "sourceVersionId": "60d0fe4f5311236168a109c9",
    "blocks": {
      "workflow_prompt": "prompt_block_123",
      "workflow_tools": "tools_block_456",
      "workflow_graph": "graph_block_789",
      "llm": "llm_block_101",
      "voice": "voice_block_202",
      "language": "language_block_303",
      "call_handling": "call_handling_block_404",
      "detection": "detection_block_505",
      "analytics": "analytics_block_606",
      "timeouts": "timeouts_block_707",
      "audio": "audio_block_808",
      "privacy": "privacy_block_909",
      "widget": "widget_block_010"
    },
    "workflowType": "workflow_graph",
    "parentVersion": "60d0fe4f5311236168a109c8",
    "isActive": false,
    "createdBy": "user_789",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-20T11:45:00Z"
  }
}

Create a new draft from an existing published version or another draft. Exactly one of sourceVersionId or sourceDraftId is required.

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

Request

This endpoint expects an object.

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

ID of a published version to branch from

sourceDraftIdstringOptional

ID of an existing draft to branch from

draftNamestringOptional<=100 characters

Optional name for the draft

Response

Draft created successfully

statusboolean

dataobject

Represents either a draft revision or a published version of an agent's configuration.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error