---
name: "agentmail-drafts"
description: "AgentMail: Operations on drafts"
---

# drafts

> **PREREQUISITE:** Read `../agentmail-shared/SKILL.md` for auth, global flags, and output formatting. If missing, run `agentmail generate-skills` to create it.

```bash
agentmail drafts <method> [flags]
```

## API Resources

 - `get` — Get Draft
 - `get-attachment` — Get Attachment
 - `list` — List Drafts
## Discovering Commands

**Agents: always prefer `--schema` over `--help`** — `--schema` returns JSON; `--help` returns human prose.

```bash
# Machine-readable surface (use this)
agentmail drafts --schema
agentmail drafts <method> --schema

# Human-readable help (for humans)
agentmail drafts --help
```