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

# metrics

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

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

## API Resources

 - `query-events` — Query Events
 - `query-usage` — Query Usage
## Discovering Commands

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

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

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