resend-cli 2.8.1 → 2.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend-cli",
-  "version": "2.8.1",
+  "version": "2.10.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"
   },
   "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.5.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 |
@@ -167,7 +169,7 @@ Read the matching reference file for detailed flags and output shapes.
 | 1 | **Forgetting `--yes` on delete commands** | All `delete`/`rm` subcommands require `--yes` in non-interactive mode — otherwise the CLI exits with an error |
 | 2 | **Not saving webhook `signing_secret`** | `webhooks create` shows the secret once only — it cannot be retrieved later. Capture it from command output immediately |
 | 3 | **Omitting `--quiet` in CI** | Without `-q`, spinners and status text still go to stderr (not stdout). Use `-q` for JSON on stdout with no spinner noise on stderr |
-| 4 | **Using `--scheduled-at` with batch** | Batch sending does not support `scheduled_at` — use single `emails send` instead |
+| 4 | **Passing `--scheduled-at` as a flag to batch** | There is no `--scheduled-at` flag on `emails batch` — set `scheduled_at` per-email in the JSON file instead |
 | 5 | **Expecting `domains list` to include DNS records** | List returns summaries only — use `domains get <id>` for the full `records[]` array |
 | 6 | **Sending a dashboard-created broadcast via CLI** | Only API-created broadcasts can be sent with `broadcasts send` — dashboard broadcasts must be sent from the dashboard |
 | 7 | **Passing `--events` to `webhooks update` expecting additive behavior** | `--events` replaces the entire subscription list — always pass the complete set |
@@ -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}`
 
 ---
 
@@ -84,14 +85,16 @@ Send up to 100 emails in a single request.
 ```json
 [
   {"from":"a@domain.com","to":["b@example.com"],"subject":"Hi","text":"Body"},
-  {"from":"a@domain.com","to":["c@example.com"],"subject":"Hi","html":"<b>Body</b>"}
+  {"from":"a@domain.com","to":["c@example.com"],"subject":"Hi","html":"<b>Body</b>","scheduled_at":"in 1 hour","tags":[{"name":"campaign","value":"welcome"}]}
 ]
 ```
 
+Per-email `scheduled_at` (ISO 8601 or natural language) and `tags` are supported.
+
 **Output (success):** `[{"id":"..."},{"id":"..."}]`
 **Output (permissive with errors):** `{"data":[{"id":"..."}],"errors":[{"index":1,"message":"..."}]}`
 
-**Constraints:** Max 100 emails. Attachments and `scheduled_at` not supported per-email.
+**Constraints:** Max 100 emails. Attachments not supported per-email.
 
 ---
 

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}]}`