Create a draft

Deprecated

POST

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

POST

/atoms/v1/agent/:id/drafts

from smallestai import SmallestAI
client = SmallestAI(
    token="YOUR_TOKEN_HERE",
)
client.atoms.agent_versioning_drafts.create_a_draft(
    id="id",
)

{
  "status": true,
  "data": {
    "_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"
  }
}

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

Create a new draft from an existing published version or another draft. At least one of sourceVersionId or sourceDraftId is required (both may be sent simultaneously).

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.

Request

This endpoint expects an object.

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

ID of a published version to branch from. Must be a 24-character hex id. Any other format returns 400.

sourceDraftIdstringOptional

ID of an existing draft to branch from

draftNamestringOptional1-100 characters

Optional name for the draft (1–100 characters)

Response

Draft created successfully

statusbooleanOptional

dataobjectOptional

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

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error