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

# threads

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

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

## API Resources

 - `delete` — Delete Thread
 - `get` — Get Thread
 - `get-attachment` — Get Attachment
 - `list` — List Threads
 - `search` — Search Threads
 - `update` — Update Thread
## Discovering Commands

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

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

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