resend-cli 2.8.1 → 2.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend-cli",
-  "version": "2.8.1",
+  "version": "2.9.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.17.1"
+    "resend": "6.18.0-canary.0"
   },
   "pkg": {
     "scripts": [

package/skills/resend-cli/SKILL.md

@@ -13,7 +13,7 @@ metadata:
   author: resend
   # Skill version is independent from the CLI/package.json version —
   # bump it on skill content changes, not CLI releases.
-  version: "2.3.0"
+  version: "2.4.0"
   homepage: https://resend.com/docs/cli-agents
   source: https://github.com/resend/resend-cli
   openclaw:
@@ -57,6 +57,7 @@ references:
   - references/templates.md
   - references/topics.md
   - references/logs.md
+  - references/suppressions.md
   - references/webhooks.md
   - references/auth.md
   - references/workflows.md
@@ -143,6 +144,7 @@ Auth resolves: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend lo
 | `emails receiving` | list, get, attachments, forward, listen |
 | `domains` | create, verify, get, claim, update, delete, list |
 | `logs` | list, get, open |
+| `suppressions` _(beta)_ | list, add, get, delete, batch — requires account enrollment |
 | `api-keys` | create, list, delete |
 | `automations` | create, get, list, update, delete, stop, open, runs |
 | `events` | create, get, list, update, delete, send, open |
@@ -220,6 +222,7 @@ resend doctor -q
 - **Defining contact properties** → [references/contact-properties.md](references/contact-properties.md)
 - **Working with templates** → [references/templates.md](references/templates.md)
 - **Viewing API request logs** → [references/logs.md](references/logs.md)
+- **Managing the suppression list** (beta) → [references/suppressions.md](references/suppressions.md)
 - **Creating automations or sending events** → [references/automations.md](references/automations.md)
 - **Setting up webhooks or listening for events** → [references/webhooks.md](references/webhooks.md)
 - **Auth, profiles, or health checks** → [references/auth.md](references/auth.md)

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

@@ -44,6 +44,7 @@ Retrieve a sent email by ID.
 {
   "object": "email",
   "id": "<uuid>",
+  "message_id": "<111-222-333@email.example.com>",
   "from": "you@domain.com",
   "to": ["user@example.com"],
   "subject": "Hello",
@@ -65,7 +66,7 @@ List sent emails.
 | `--after <cursor>` | string | — | Forward pagination cursor |
 | `--before <cursor>` | string | — | Backward pagination cursor |
 
-**Output:** `{"object":"list","data":[...],"has_more":bool}`
+**Output:** `{"object":"list","data":[{"id":"...","message_id":"<111-222-333@email.example.com>",...}],"has_more":bool}`
 
 ---
 

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

@@ -0,0 +1,101 @@
+# suppressions
+
+Detailed flag specifications for `resend suppressions` commands.
+
+> **Beta:** Suppressions is a pre-GA feature gated per account. Commands appear in
+> `--help` but return an API error unless the suppression list is enabled for your
+> account. Reach out to Resend to join the beta.
+
+Suppressions block future sends to an address. Each entry has an `origin`:
+
+| Origin | Meaning |
+|--------|---------|
+| `bounce` | Added automatically after a hard bounce |
+| `complaint` | Added automatically after a spam complaint |
+| `manual` | Added by you via `suppressions add` |
+
+`get` and `delete` accept **either** a suppression ID **or** the email address.
+
+---
+
+## suppressions list
+
+List suppressed addresses (default subcommand — `resend suppressions` alone runs it).
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--limit <n>` | number | 10 | Max results, 1-100 |
+| `--after <cursor>` | string | — | Forward pagination cursor |
+| `--before <cursor>` | string | — | Backward pagination cursor |
+| `--origin <origin>` | string | — | Filter: `bounce` \| `complaint` \| `manual` |
+
+**Alias:** `ls`
+
+**Output:** `{"object":"list","has_more":false,"data":[{"object":"suppression","id":"...","email":"...","origin":"bounce|complaint|manual","source_id":"..."|null,"created_at":"..."}]}`
+
+---
+
+## suppressions add
+
+Suppress a single email address (origin `manual`).
+
+**Argument:** `<email>` — email address to suppress (required in non-interactive mode)
+
+**Output:** `{"object":"suppression","id":"..."}`
+
+---
+
+## suppressions get
+
+Retrieve a single suppression.
+
+**Argument:** `<id-or-email>` — suppression ID or the suppressed email address
+
+**Output:** `{"object":"suppression","id":"...","email":"...","origin":"...","source_id":"..."|null,"created_at":"..."}`
+
+---
+
+## suppressions delete
+
+Remove a suppression so Resend can send to the address again.
+
+**Argument:** `<id-or-email>` — suppression ID or the suppressed email address
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--yes` | boolean | Yes (non-interactive) | Skip confirmation |
+
+**Alias:** `rm`
+
+**Output:** `{"object":"suppression","id":"...","deleted":true}`
+
+---
+
+## suppressions batch add
+
+Suppress up to 100 addresses in one request.
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--file <path>` | string | Yes (non-interactive) | JSON file with an array of email strings (`-` for stdin) |
+
+**File format:** `["a@example.com", "b@example.com"]`
+
+**Output:** `{"data":[{"object":"suppression","id":"..."}]}`
+
+---
+
+## suppressions batch remove
+
+Remove up to 100 suppressions in one request.
+
+| Flag | Type | Required | Description |
+|------|------|----------|-------------|
+| `--file <path>` | string | Yes (non-interactive) | JSON file with an array of strings (`-` for stdin) |
+| `--ids` | boolean | No | Treat file entries as suppression IDs instead of emails |
+
+**Alias:** `rm`
+
+**File format:** `["a@example.com", "b@example.com"]` (or IDs with `--ids`)
+
+**Output:** `{"data":[{"object":"suppression","id":"...","deleted":true}]}`