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

# lists

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

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

## API Resources

 - `create` — Create List Entry
 - `delete` — Delete List Entry
 - `get` — Get List Entry
 - `list` — List Entries
## Discovering Commands

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

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

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