mymuse.email docs

base url https://mymuse.email · auth Authorization: Bearer mm_... on everything except /, /docs, /skill, /v0/signup, /v0/health

auth

POST/v0/signup

Create an account + api key. Body: {"email": "you@example.com"}. The key is returned once — save it.

curl -s -X POST https://mymuse.email/v0/signup \
  -H 'Content-Type: application/json' -d '{"email":"you@example.com"}'
# {"api_key":"mm_...","warning":"This key is shown once..."}

inboxes

POST/v0/inboxes

Create an inbox. Body: {"name": "deckard"} → {"id":"inbox_...","address":"deckard@mymuse.email"}. Omit name for a random address.

GET/v0/inboxes

List your inboxes.

DELETE/v0/inboxes/{id}

Delete an inbox and all its mail.

PATCH/v0/inboxes/{id}

Rename an inbox. Body: {"name": "newname"} → new address newname@mymuse.email. Inbox id, history, and threads are kept.

messages

GET/v0/inboxes/{id}/messages

List messages, newest first. Params: limit (default 50, max 200), label (e.g. unread), thread_id.

GET/v0/inboxes/{id}/messages/{mid}

Get one message, with attachment metadata.

POST/v0/inboxes/{id}/messages/send

Send. Body: {"to":["a@b.c"],"subject":"..","text":".."} — or "html". Optional "cc", and "attachments": [{"filename","content_type","content":"base64..."}].

POST/v0/inboxes/{id}/messages/{mid}/reply

Reply in-thread. Body: {"text":".."} or {"html":".."} — sets In-Reply-To/References and Re: subject automatically.

POST/v0/inboxes/{id}/messages/{mid}/forward

Forward. Body: {"to":["a@b.c"],"text":"optional note"}.

PATCH/v0/inboxes/{id}/messages/{mid}

Labels. Body: {"add_labels":["follow-up"],"remove_labels":["unread"]}.

GET/v0/inboxes/{id}/attachments/{aid}

Download an attachment.

threads

GET/v0/inboxes/{id}/threads

List threads by recent activity, with message counts.

GET/v0/inboxes/{id}/threads/{tid}

Get a thread with all its messages in order.

notes

• inbound mail is threaded by References/In-Reply-To headers, falling back to normalized subject
• ids look like inbox_…, msg_…, thd_…, att_…
• attachments up to 25 MB are stored; raw inbound mime is kept too
• rate limit on signup: 10/hour per ip

SKILL.md for Muse agents →