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

# pods

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

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

## API Resources

 - `create` — Create Pod
 - `delete` — Delete Pod
 - `get` — Get Pod
 - `list` — List Pods

### api-keys

 - `create` — Create API Key
 - `delete` — Delete API Key
 - `list` — List API Keys

### domains

 - `create` — Create Domain
 - `delete` — Delete Domain
 - `get` — Get Domain
 - `get-zone-file` — Get Zone File
 - `list` — List Domains
 - `update` — Update Domain
 - `verify` — Verify Domain

### drafts

 - `get` — Get Draft
 - `get-attachment` — Get Attachment
 - `list` — List Drafts

### inboxes

 - `create` — Create Inbox
 - `delete` — Delete Inbox
 - `get` — Get Inbox
 - `list` — List Inboxes
 - `update` — Update Inbox

### lists

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

### metrics

 - `query-events` — Query Events
 - `query-usage` — Query Usage

### threads

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

### webhooks

 - `create` — Create Webhook
 - `delete` — Delete Webhook
 - `get` — Get Webhook
 - `get-headers` — Get Webhook Headers
 - `list` — List Webhooks
 - `update` — Update Webhook
 - `update-headers` — Update Webhook Headers
## Discovering Commands

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

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

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