SpiderMail

AI Compose

AI Compose helps you draft and polish email text before you send it. Give it what you have — a rough draft, a few notes, or an existing message — and it returns improved copy you can drop straight into a send. It is a writing aid, not a send action: it never delivers anything on its own.

What it can do

POST /mail/compose/assist takes an action that says how to transform your text:

::table
Action | What it does
write | Draft a new message from your notes
rewrite | Rephrase existing text, same meaning
expand | Flesh a terse note into a fuller message
shorten | Tighten a long message
formal | Make the tone more formal
casual | Make the tone more casual
fix_grammar | Correct grammar and spelling only

Polish a draft

Pass the text you are working on as context, choose an action, and optionally set a tone:

curl -X POST "https://spideriq.ai/api/v1/mail/compose/assist" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "rewrite",
    "context": "hey just checking if u got my last email about the demo lmk",
    "tone": "professional"
  }'

The fields:

  • action (required) — one of the actions in the table above.

  • context (required) — the text to work from (your draft, or notes for write).

  • tone (optional) — professional (default), friendly, casual, or formal.

  • subject (optional) — the email subject, for better context.

  • thread_context (optional) — prior messages in the thread, so the suggestion fits the conversation.

The response is the suggested text. Review it, edit if you like, then send it with a normal send job.

From an agent

Agents can call the equivalent compose_assist MCP tool, which takes a prompt describing what to write, an optional draft to improve, optional context, and a tone. See MCP Tools.

Tip: AI Compose returns text only — it is deliberately decoupled from sending. Generate, review, then submit a send job. This keeps a human (or an explicit agent step) in the loop before anything leaves your mailbox.

Next steps

  1. Send the polished message.

  2. Save a recurring structure as a template.

  3. Endpoint details in the API Reference.