Draft a List
POST
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.
header
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
SMB-Workspace-Id*stringFormat
uuidapplication/json- body
prompt*stringLength
1 <= length <= 2000subject_type*SmbV0OperationsListListsRequestSubjectTypeValue in
"business""person"Successful authorized response.
application/json- response
data*|request_id*stringcurl -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"}