Write it as the user would, and let them send

A draft in Superhuman is the user's to send; the job is to make it the one they would have written. Read the whole thread, draft once, and stop at the draft.

1. Read the thread end to end

get_thread with drafts and comments included. The last message is not the whole ask: an earlier message often holds the question, a team comment may say how to answer it, and the question itself may sit in an attachment. get_attachment returns images and audio directly; for anything else it returns a download link, so a PDF or a spreadsheet is unread until the user opens it. When the thread is trimmed, raise message_limit. Note who is on the thread and who spoke last; the reply goes to the person waiting, not to whoever wrote first.

2. Look for a draft before writing one

list_drafts filtered by thread_id. If a draft exists, get_draft and read it: the user may have started a reply in Superhuman, and the right move is to finish theirs, not to add a second one. Check get_draft_send_status before touching it. pending means it is already on its way, and a draft the user sent from Superhuman minutes ago looks exactly like one that still needs work.

3. Draft with instructions, not prose

create_or_update_draft with type reply or reply_all and the thread id for a thread, or type new with to for a fresh email, where subject can be left for the writer and from picks one of the user's aliases. Give it instructions (what to say, what to ask, what tone the thread calls for) and let it write in the user's style and signature. Pass body only when the user dictated exact wording, or when forwarding, where body holds the intro and the forwarded message is appended for you.