---
name: "mymuse"
description: "Email for Muse agents via mymuse.email: create inboxes at @mymuse.email, send, receive, reply, thread, and download attachments."
---

# mymuse.email — email for Muse agents

Base URL: `https://mymuse.email`. Auth: `Authorization: Bearer mm_...` on all /v0/* except /v0/signup and /v0/health.

## Signup (once per human)

```bash
curl -s -X POST https://mymuse.email/v0/signup \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'
# -> {"api_key":"mm_..."}  (shown once, save it)
```

## Inboxes

```bash
API=https://mymuse.email; K="Authorization: Bearer mm_YOURKEY"
curl -s -X POST $API/v0/inboxes -H "$K" -H 'Content-Type: application/json' -d '{"name":"deckard"}'
# -> {"id":"inbox_...","address":"deckard@mymuse.email"}
curl -s $API/v0/inboxes -H "$K"
curl -s -X DELETE $API/v0/inboxes/inbox_... -H "$K"
```

## Messages

```bash
# list (label=unread, limit, thread_id params)
curl -s "$API/v0/inboxes/inbox_.../messages?label=unread&limit=20" -H "$K"
# get one (includes attachments metadata)
curl -s $API/v0/inboxes/inbox_.../messages/msg_... -H "$K"
# send
curl -s -X POST $API/v0/inboxes/inbox_.../messages/send -H "$K" -H 'Content-Type: application/json' \
  -d '{"to":["friend@example.com"],"subject":"hi","text":"sent by my muse"}'
# reply (threads automatically)
curl -s -X POST $API/v0/inboxes/inbox_.../messages/msg_.../reply -H "$K" -H 'Content-Type: application/json' \
  -d '{"text":"on it"}'
# forward
curl -s -X POST $API/v0/inboxes/inbox_.../messages/msg_.../forward -H "$K" -H 'Content-Type: application/json' \
  -d '{"to":["other@example.com"]}'
# labels
curl -s -X PATCH $API/v0/inboxes/inbox_.../messages/msg_... -H "$K" -H 'Content-Type: application/json' \
  -d '{"remove_labels":["unread"],"add_labels":["done"]}'
# download attachment
curl -s -OJ "$API/v0/inboxes/inbox_.../attachments/att_..." -H "$K"
```

## Threads

```bash
curl -s $API/v0/inboxes/inbox_.../threads -H "$K"
curl -s $API/v0/inboxes/inbox_.../threads/thd_... -H "$K"
```

Inbound mail to <name>@mymuse.email lands in that inbox automatically, parsed and threaded.