resend-cli 2.15.0 → 2.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend-cli",
-  "version": "2.15.0",
+  "version": "2.17.0",
   "description": "The official CLI for Resend",
   "license": "MIT",
   "repository": {
@@ -46,7 +46,7 @@
     "esbuild": "0.28.1",
     "esbuild-wasm": "0.28.0",
     "picocolors": "1.1.1",
-    "resend": "6.21.0"
+    "resend": "6.23.0"
   },
   "pkg": {
     "scripts": [

package/skills/resend-cli/SKILL.md

@@ -141,7 +141,7 @@ Auth resolves: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend lo
 
 | Command Group | What it does |
 |--------------|-------------|
-| `emails` | send, get, list, batch, cancel, update |
+| `emails` | send, get, list, batch, cancel, update, metrics |
 | `emails receiving` | list, get, attachments, forward, listen |
 | `domains` | create, verify, get, claim, update, delete, list |
 | `logs` | list, get, open |
@@ -150,10 +150,10 @@ Auth resolves: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend lo
 | `api-keys` | create, list, update, delete |
 | `automations` | create, get, list, update, delete, duplicate, stop, open, runs |
 | `events` | create, get, list, update, delete, send, open |
-| `broadcasts` | create, send, update, delete, list |
+| `broadcasts` | create, send, get, update, delete, list, cancel, open, clicked-links, recipients |
 | `contacts` | create, update, delete, segments, topics, imports |
 | `contact-properties` | create, update, delete, list |
-| `segments` | create, get, list, delete, contacts |
+| `segments` | create, get, list, update, delete, contacts |
 | `templates` | create, publish, duplicate, delete, list |
 | `topics` | create, update, delete, list |
 | `webhooks` | create, update, listen, delete, list |

package/skills/resend-cli/references/broadcasts.md

@@ -43,6 +43,25 @@ Returns full object with html/text, from, subject, status (`draft`|`queued`|`sen
 
 ---
 
+## broadcasts recipients
+
+**Argument:** `[id]` — Broadcast ID
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--type <type>` | string | Yes (non-interactive) | Event to filter by: `sent`, `delivered`, `opened`, `clicked`, `bounced`, `complained`, `unsubscribed`, `suppressed` |
+| `--email <email>` | string | No | Substring filter on recipient email |
+| `--bounce-type <type>` | string | No | Bounce classification: `permanent`, `transient`, `undetermined` — only meaningful when `--type bounced` |
+| `--limit <n>` | number | No | Max results (1-100, default 20) |
+| `--after <cursor>` | string | No | Forward pagination |
+| `--before <cursor>` | string | No | Backward pagination |
+
+Returns `id` (opaque pagination cursor), `contact_id` (nullable), `email`, and, depending on `--type`: `count` (`opened`/`clicked`), `bounce_type` (`bounced`), `clicked_links` (`clicked`).
+
+**Note:** Responses are cached for up to 15 minutes, so requesting the same page again may return slightly stale data within that window.
+
+---
+
 ## broadcasts send
 
 Send a draft broadcast.
@@ -100,3 +119,17 @@ Cancelling a queued broadcast stops it mid-send — emails already sent are not
 Open a broadcast (or the broadcasts list) in the Resend dashboard.
 
 **Argument:** `[id]` — Broadcast ID (omit to open the list)
+
+---
+
+## broadcasts clicked-links
+
+List the links clicked in a broadcast, ranked by total clicks.
+
+**Argument:** `[id]` — Broadcast ID
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--limit <n>` | number | 10 | Max results (1-100) |
+| `--after <cursor>` | string | — | Forward pagination |
+| `--before <cursor>` | string | — | Backward pagination |

package/skills/resend-cli/references/emails.md

@@ -138,6 +138,28 @@ Update a scheduled email.
 
 ---
 
+## emails metrics
+
+Retrieve account-level email metrics for a date range, with optional breakdowns.
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--start-date <date>` | string | 6 days before `--end-date` | ISO 8601 date or datetime |
+| `--end-date <date>` | string | now | ISO 8601 date or datetime |
+| `--timezone <tz>` | string | UTC | IANA timezone used to bucket periods |
+| `--granularity <granularity>` | string | daily | `hourly`, `daily`, `weekly`, or `monthly` |
+| `--metrics <list>` | string | all | Comma-separated metrics to include |
+| `--dimensions <list>` | string | — | Comma-separated breakdowns: `period`, `domain`, `email`, `broadcast` |
+| `--domain-id <list>` | string | — | Comma-separated sending domain IDs (max 100) |
+| `--email-id <list>` | string | — | Comma-separated email IDs (max 100) |
+| `--broadcast-id <list>` | string | — | Comma-separated broadcast IDs (max 100) |
+
+The `email` and `broadcast` dimensions/filters cannot be combined. Without `--dimensions`, the response has totals only and no `data` array.
+
+**Output:** `{"object":"metrics","start_date":"...","end_date":"...","metrics":["sent",...],"dimensions":["period"],"granularity":"daily","totals":{"sent":100,...},"data":[{"period":"2026-07-01","sent":10,...}]}`
+
+---
+
 ## emails receiving list
 
 List received (inbound) emails. Requires domain receiving enabled.

package/skills/resend-cli/references/segments.md

@@ -28,6 +28,20 @@ Detailed flag specifications for `resend segments` commands.
 
 ---
 
+## segments update
+
+Rename a segment.
+
+**Argument:** `[id]` — Segment UUID (interactive picker if omitted)
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--name <name>` | string | Yes (non-interactive) | New segment name |
+
+**Output:** `{"object":"segment","id":"..."}`
+
+---
+
 ## segments delete
 
 **Argument:** `<id>` — Segment UUID