Create a draft

Deprecated

POST

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

POST

/atoms/v1/agent/:id/drafts

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

1 {
2   "status": true,
3   "data": {
4     "_id": "5f8d0d55b54764421b7156c3",
5     "agent": "5f8d0d55b54764421b7156a1",
6     "status": "draft",
7     "versionNumber": 3,
8     "label": "Q2 Marketing Campaign Update",
9     "description": "Updated call flow to include new promotional offers and revised greeting scripts.",
10     "isPinned": false,
11     "publishedBy": "user_987654321",
12     "publishedAt": "2024-01-15T09:30:00Z",
13     "activatedBy": "user_123456789",
14     "activatedAt": "2024-01-15T09:30:00Z",
15     "draftId": "draft_5f8d0d55b54764421b7156d9",
16     "draftName": "Q2 Campaign Draft",
17     "draftRevision": 2,
18     "sourceVersionId": "5f8d0d55b54764421b7156b7",
19     "blocks": {
20       "workflow_prompt": "prompt_block_001",
21       "workflow_tools": "tools_block_002",
22       "workflow_graph": "graph_block_003",
23       "llm": "llm_block_004",
24       "voice": "voice_block_005",
25       "language": "language_block_006",
26       "call_handling": "call_handling_block_007",
27       "detection": "detection_block_008",
28       "analytics": "analytics_block_009",
29       "timeouts": "timeouts_block_010",
30       "audio": "audio_block_011",
31       "privacy": "privacy_block_012",
32       "widget": "widget_block_013"
33     },
34     "workflowType": "workflow_graph",
35     "parentVersion": "5f8d0d55b54764421b7156b6",
36     "isActive": true,
37     "createdBy": "user_123456789",
38     "createdAt": "2024-01-10T08:00:00Z",
39     "updatedAt": "2024-01-15T09:30:00Z"
40   }
41 }

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).

**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](/voice-agents/deprecations/agent-versioning-migration). 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 valid MongoDB ObjectId (24-char hex). Sending a non-ObjectId 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

statusboolean

dataobject

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