Beta

Draft a List

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
POST
/v1/lists/draft

Turn a description into a supported definition and read-only preview, or ask for clarification. One bounded AI call; no List is saved. Use create_list only after explicit approval of the draft.

Authorization

headerAuthorizationBearer <token>

A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.

Header Parameters

SMB-Workspace-Id*string
Formatuuid

Request Body

application/json
  1. body
prompt*string
Length1 <= length <= 2000
subject_type*SmbV0OperationsListListsRequestSubjectType
Value in"business""person"

Response Body

Successful authorized response.

application/json
  1. response
data*|
request_id*string
curl -X POST 'https://example.com/v1/lists/draft' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{  "prompt": "string",  "subject_type": "business"}'
{  "data": {    "status": "needs_clarification",    "question": "string"  },  "request_id": "string"}