Create a draft

Saves a message in the inbox to finish, review or send later. Saving uses no sending allowance. Every field is optional ({} saves an empty draft) and takes the formats and limits of send; recipients, subject and text are checked when you send. Creation returns metadata only: retrieve the draft for its content.

Prepare a reply or forward

Set source to an action (reply, reply-all or forward) and a message_id, a ready received message or an accepted sent message in this inbox, to have Cherami fill in the draft once, at creation:

• reply and reply-all save the recipients, subject and in_reply_to derived as for reply and reply-all. Fields you supply override them, including an empty array or a null in_reply_to. Your text and attachments make up the reply; no history or original files are copied. The message you reply to must still exist when you send, and changing in_reply_to later doesn't re-derive recipients or subject.
• forward saves the full forward as text and HTML, with your text as the note, plus the original attachments unless source.include_attachments is false. Add recipients now or later. attachments can't be supplied with a forward source; edit the draft afterwards to change its files.

Recover creation

Include an idempotency_key to make a retry safe. If creation is uncertain, repeat the exact request with the same key within 24 hours of your first attempt: a match returns 200 with replayed: true and the draft's current metadata, without applying the payload again.

After 24 hours, or without a key, list drafts with state=all before creating again: a blind repeat makes a duplicate.