/v1/comms/drafts/aiDraft a message with Neo
Writes a first pass at an email or text about one record and files it in the approval queue, unsent. Takes the record (definitionKey, rowId), a medium (email or sms), an intent saying what the message is for, the recipient, an optional tone (shorter, warmer or firmer), an optional note in the person's own words, and an optional templateId to rewrite from. The answer STREAMS as server-sent events and ends with the draft row's id, its subject and body, and any figure in the words the record's own facts do not support. It never sends: approving the draft and sending it are separate acts. The draft names no mailbox and no From can be set on it: to send from a line the person named, send the words with post_comms_send and account_identifier set to it from get_comms_senders. THE MODEL WRITES THE WORDS: note and intent steer it, and it may reword, shorten or add to them — so it is the wrong tool when the person gave the exact wording ("use exactly this", a body pasted in quotes). For that, send the words as given (post_comms_send, or post_comms_conversations_id_messages to answer a thread), shown first in the plan when the person wants to review them; post_message-drafts with definitionKey + rowId saves the words as given only when they ask for a draft to approve later (2026-10-08: dictated messages came back with figures and a misspelled name before being patched). On a record, the draft also reads the person's standing rules and that record's newest thread of the medium, our messages included; conversationId beside the record names which of its threads it answers. An email draft carries no sign-off, because its sending address signs it; a text draft ends as the person's rule for texts says, or without one.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredValues: "email" · "sms"
Values: "firmer" · "shorter" · "warmer"
Responses
the action's answer
{}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}