resend-cli 2.22.0-preview-inboxes.1 → 2.22.0-preview-inboxes.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend-cli",
-  "version": "2.22.0-preview-inboxes.1",
+  "version": "2.22.0-preview-inboxes.3",
   "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.28.1-preview-inboxes.0"
+    "resend": "6.32.1-preview-inboxes.1"
   },
   "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.18.0"
+  version: "2.20.0"
   homepage: https://resend.com/docs/cli-agents
   source: https://github.com/resend/resend-cli
   openclaw:
@@ -137,7 +137,7 @@ Auth resolves: `RESEND_API_KEY` env > config file (`resend login --key`). Use `-
 | `logs` | list, get, open |
 | `careers` | list, apply — browse open positions at Resend and apply |
 | `suppressions` _(beta)_ | list, add, get, delete, batch — requires account enrollment |
-| `inboxes` _(beta)_ | create, list, get, update, delete, threads (list, get, update, delete, emails get/reply/forward), labels, drafts — requires account enrollment |
+| `inboxes` _(beta)_ | create, list, get, update, delete, threads (list, get, update, delete, emails list/get/reply/forward), labels, drafts — requires account enrollment |
 | `api-keys` | create, list, update, delete |
 | `automations` | create, get, list, update, delete, duplicate, stop, open, runs |
 | `events` | create, get, list, update, delete, send, open |

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

@@ -6,9 +6,10 @@ Detailed flag specifications for `resend inboxes` commands.
 > `--help` but return an API error unless inboxes is enabled for your account.
 > Reach out to Resend to join the beta.
 
-An inbox is an email address at one of your verified domains (with receiving
-enabled) that can receive email. Received messages are grouped into threads
-inside the inbox. Inboxes require a **full-access** API key — sending-only keys
+An inbox is an email address at one of your verified domains that sends and
+receives email. Receiving must be enabled on the domain, unless the inbox is
+created with `--forwarding`. Received messages are grouped into threads inside
+the inbox. Inboxes require a **full-access** API key — sending-only keys
 are rejected.
 
 ---
@@ -21,10 +22,10 @@ Create a new inbox at one of your verified domains.
 |------|------|----------|-------------|
 | `--email_address <address>` | string | Yes (non-interactive) | Address for the inbox, e.g. `support@yourdomain.com` |
 | `--name <name>` | string | No | Inbox name shown in the dashboard (max 64 chars) |
-| `--friendly_name <name>` | string | No | Name used when sending from this inbox, e.g. `Ada from Support` |
-| `--forwarding` | boolean | No | Enable forwarding — received emails are also forwarded to a generated forwarding address |
+| `--from_name <name>` | string | No | Name used when sending from this inbox, e.g. `Ada from Support`. A plain name, not `Name <email>` |
+| `--forwarding` | boolean | No | Receive mail without an MX record — Resend returns a `receiving_address` to forward mail to |
 
-**Output:** `{"object":"inbox","id":"<uuid>","name":"<name>","email_address":"<address>","domain_id":"<uuid>","forwarding_address":"<address>"|null,"unread":0,"created_at":"<date>"}`
+**Output:** `{"object":"inbox","id":"<uuid>","name":"<name>","email_address":"<address>","domain_id":"<uuid>","receiving_address":"<address>"|null,"from_name":"<name>"|null,"unread":0,"drafts":0,"last_received":"<date>"|null,"created_at":"<date>"}`
 
 ---
 
@@ -40,23 +41,23 @@ List all inboxes (default subcommand — `resend inboxes` alone runs it).
 
 **Alias:** `ls`
 
-**Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","name":"<name>"|null,"email_address":"<address>","unread":0,"last_received":"<date>"|null}]}`
+**Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","name":"<name>"|null,"email_address":"<address>","from_name":"<name>"|null,"unread":0,"last_received":"<date>"|null}]}`
 
 ---
 
 ## inboxes get
 
-Retrieve a single inbox.
+Retrieve a single inbox by ID or email address.
 
-**Argument:** `<id>` — inbox UUID (required in non-interactive mode)
+**Argument:** `<id>` — inbox UUID or inbox email address, e.g. `support@yourdomain.com` (required in non-interactive mode)
 
-**Output:** `{"object":"inbox","id":"<uuid>","name":"<name>"|null,"email_address":"<address>","forwarding_address":"<address>"|null,"unread":0,"drafts":0,"last_received":"<date>"|null}`
+**Output:** `{"object":"inbox","id":"<uuid>","name":"<name>","email_address":"<address>","domain_id":"<uuid>","receiving_address":"<address>"|null,"from_name":"<name>"|null,"unread":0,"drafts":0,"last_received":"<date>"|null,"created_at":"<date>"}`
 
 ---
 
 ## inboxes update
 
-Update an inbox's name or friendly name. At least one option is required.
+Update an inbox's name or from name. At least one option is required.
 The email address cannot be changed after creation.
 
 **Argument:** `<id>` — inbox UUID
@@ -64,7 +65,7 @@ The email address cannot be changed after creation.
 | Flag | Type | Description |
 |------|------|-------------|
 | `--name <name>` | string | New inbox name (max 64 chars) |
-| `--friendly_name <name>` | string | New name used when sending from this inbox |
+| `--from_name <name>` | string | New name used when sending from this inbox. A plain name, not `Name <email>`. Pass `""` to clear it |
 
 **Output:** `{"object":"inbox","id":"<uuid>"}`
 
@@ -73,32 +74,33 @@ The email address cannot be changed after creation.
 ## inboxes threads list
 
 List threads in an inbox (default subcommand of `resend inboxes threads`).
-Pages are fixed at 50 threads, newest activity first — there is no `--limit`.
+Threads are ordered by newest activity first.
 
 **Flags:** `--inbox_id <id>` — required in non-interactive mode
 
 | Flag | Type | Default | Description |
 |------|------|---------|-------------|
 | `--folder <folder>` | string | `inbox` | One of `inbox`, `archive`, `spam`, `sent`, `trash` |
-| `--query <text>` | string | — | Search subject, sender, and label names |
-| `--from <sender>` | string | — | Filter by sender address or name |
+| `--query <text>` | string | — | Case-insensitive match against thread subjects and label names |
 | `--label <label_id>` | string | — | Filter by label **UUID** (not name); repeat for multiple |
-| `--cursor <cursor>` | string | — | `next_cursor` from a previous response |
+| `--limit <n>` | number | 10 | Max results, 1-100 |
+| `--after <cursor>` | string | — | Forward pagination cursor (a thread ID) |
+| `--before <cursor>` | string | — | Backward pagination cursor (a thread ID) |
 
 **Alias:** `ls`
 
-**Output:** `{"object":"list","has_more":false,"next_cursor":"<cursor>"|null,"data":[{"id":"<uuid>","subject":"<subject>"|null,"from":"<sender>"|null,"to":[],"cc":[],"bcc":[],"labels":[],"message_count":1,"has_attachment":false,"has_draft":false,"read":false,"received_at":"<date>"}]}`
+**Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","subject":"<subject>"|null,"from":"<sender>"|null,"to":[],"cc":[],"bcc":[],"labels":[],"message_count":1,"has_attachment":false,"has_draft":false,"read":false,"received_at":"<date>"}]}`
 
 ---
 
 ## inboxes threads get
 
-Retrieve a thread with every message inline, including `html` and `text`
-bodies. Use the message `id` values as the email ID for replies.
+Retrieve a thread's summary. To read its messages, use
+`inboxes threads emails list`.
 
 **Flags:** `--inbox_id <id> --thread_id <id>` — required in non-interactive mode
 
-**Output:** `{"object":"inbox_thread","id":"<uuid>","subject":"<subject>"|null,"folder":"inbox","labels":[],"read":true,"messages":{"has_more":false,"data":[{"id":"<uuid>","direction":"inbound|outbound","from":"<sender>","to":[],"subject":"<subject>"|null,"html":"<html>"|null,"text":"<text>"|null,"attachments":[],"read":true,"received_at":"<date>"}]}}`
+**Output:** `{"object":"inbox_thread","id":"<uuid>","subject":"<subject>"|null,"folder":"inbox|archive|spam|sent|trash","labels":[],"read":true}`
 
 ---
 
@@ -136,31 +138,54 @@ Delete a thread and all of its messages.
 
 ---
 
+## inboxes threads emails list
+
+List the emails in a thread, oldest first, with their `html` and `text` bodies
+(default subcommand of `resend inboxes threads emails`). Use the email `id`
+values with `emails get`, `reply`, and `forward`.
+
+**Flags:** `--inbox_id <id> --thread_id <id>` — required in non-interactive mode
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--limit <n>` | number | 10 | Max results, 1-100 |
+| `--after <cursor>` | string | — | Forward pagination cursor (an email ID) |
+| `--before <cursor>` | string | — | Backward pagination cursor (an email ID) |
+
+**Alias:** `ls`
+
+**Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","direction":"inbound|outbound","from":"<sender>","to":[],"cc":[],"bcc":[],"reply_to":[],"subject":"<subject>"|null,"message_id":"<message-id>"|null,"html":"<html>"|null,"text":"<text>"|null,"attachments":[],"read":true,"received_at":"<date>"}]}`
+
+---
+
 ## inboxes threads emails get
 
 Retrieve a single email from a thread.
 
 **Flags:** `--inbox_id <id> --thread_id <id> --email_id <id>` — required in non-interactive mode
 
-**Output:** `{"id":"<uuid>","direction":"inbound|outbound","from":"<sender>","to":[],"cc":[],"bcc":[],"reply_to":[],"subject":"<subject>"|null,"html":"<html>"|null,"text":"<text>"|null,"attachments":[{"id":"<id>","filename":"<name>"|null,"size":123}],"read":true,"received_at":"<date>"}`
+**Output:** `{"id":"<uuid>","direction":"inbound|outbound","from":"<sender>","to":[],"cc":[],"bcc":[],"reply_to":[],"subject":"<subject>"|null,"message_id":"<message-id>"|null,"html":"<html>"|null,"text":"<text>"|null,"attachments":[{"id":"<id>","filename":"<name>"|null,"size":123|null}],"read":true,"received_at":"<date>"}`
 
 ---
 
 ## inboxes threads emails reply
 
 Reply to a specific email in a thread. The reply is sent from the inbox
-address to the sender of the original email.
+address. The recipient comes from the original email. The total number of
+recipients cannot exceed 50.
 
 **Flags:** `--inbox_id <id> --thread_id <id> --email_id <id>` — required in
-non-interactive mode; the email ID comes from `inboxes threads get`
+non-interactive mode; the email ID comes from `inboxes threads emails list`
 
 | Flag | Type | Required | Description |
 |------|------|----------|-------------|
+| `--cc <address>` | string | No | Cc address; repeat for multiple. Not copied from the original email |
+| `--bcc <address>` | string | No | Bcc address; repeat for multiple. Not copied from the original email |
 | `--text <text>` | string | One of text/html | Plain text reply body |
 | `--html <html>` | string | One of text/html | HTML reply body |
 | `--subject <subject>` | string | No | Override the reply subject |
 
-**Output:** `{"id":"<uuid>","email_id":"<uuid>","direction":"outbound","from":"<inbox-address>","to":["<recipient>"],"text":"<text>"|null,"html":"<html>"|null,"read":true,"received_at":"<date>"}`
+**Output:** `{"id":"<uuid>","email_id":"<uuid>","direction":"outbound","from":"<inbox-address>","to":["<recipient>"],"cc":[],"bcc":[],"reply_to":[],"subject":"<subject>"|null,"message_id":"<message-id>"|null,"html":"<html>"|null,"text":"<text>"|null,"attachments":[],"read":true,"received_at":"<date>"}`
 
 ---
 
@@ -173,11 +198,15 @@ Forward an email to other recipients from the inbox address.
 | Flag | Type | Required | Description |
 |------|------|----------|-------------|
 | `--to <address>` | string | Yes | Recipient; repeat the flag for multiple |
+| `--cc <address>` | string | No | Cc address; repeat for multiple |
+| `--bcc <address>` | string | No | Bcc address; repeat for multiple |
 | `--text <text>` | string | No | Plain text note to include |
 | `--html <html>` | string | No | HTML note to include |
 | `--subject <subject>` | string | No | Override the forwarded subject |
 
-**Output:** `{"id":"<uuid>","email_id":"<uuid>","direction":"outbound","from":"<inbox-address>","to":["<recipient>"],"text":"<text>"|null,"html":"<html>"|null,"attachments":[],"read":true,"received_at":"<date>"}`
+`--to`, `--cc`, and `--bcc` combined cannot exceed 50 recipients.
+
+**Output:** `{"id":"<uuid>","email_id":"<uuid>","direction":"outbound","from":"<inbox-address>","to":["<recipient>"],"cc":[],"bcc":[],"reply_to":[],"subject":"<subject>"|null,"message_id":"<message-id>"|null,"html":"<html>"|null,"text":"<text>"|null,"attachments":[],"read":true,"received_at":"<date>"}`
 
 ---
 
@@ -191,7 +220,7 @@ List all labels in an inbox (not paginated; default subcommand of
 
 **Alias:** `ls`
 
-**Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","name":"<name>","color":"<color>","created_at":"<date>"}]}`
+**Output:** `{"object":"list","data":[{"id":"<uuid>","name":"<name>","color":"<color>","created_at":"<date>"}]}`
 
 ---
 
@@ -244,25 +273,27 @@ Delete a label. It is removed from every thread that has it.
 ## inboxes drafts list
 
 List drafts in an inbox (default subcommand of `resend inboxes drafts`).
-Opaque cursor pagination like threads — no `--limit`.
 
 **Flags:** `--inbox_id <id>` — required in non-interactive mode
 
-| Flag | Type | Description |
-|------|------|-------------|
-| `--cursor <cursor>` | string | `next_cursor` from a previous response |
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--limit <n>` | number | 10 | Max results, 1-100 |
+| `--after <cursor>` | string | — | Forward pagination cursor (a draft ID) |
+| `--before <cursor>` | string | — | Backward pagination cursor (a draft ID) |
 
 **Alias:** `ls`
 
-**Output:** `{"object":"list","has_more":false,"next_cursor":"<cursor>"|null,"data":[{"id":"<uuid>","type":"standalone|reply","to":["<address>"]|null,"cc":[],"bcc":[],"subject":"<subject>"|null,"snippet":"<text>"|null,"thread_id":"<uuid>"|null,"reply_to_email_id":"<uuid>"|null,"updated_at":"<date>"}]}`
+**Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","type":"standalone|reply","to":["<address>"]|null,"cc":[],"bcc":[],"subject":"<subject>"|null,"snippet":"<text>"|null,"thread_id":"<uuid>"|null,"reply_to_email_id":"<uuid>"|null,"updated_at":"<date>"}]}`
 
 ---
 
 ## inboxes drafts create
 
 Create a standalone draft, or a reply draft when `--thread_id` and
-`--reply_to_email_id` are passed **together**. At least one content field is
-required.
+`--reply_to_email_id` are passed **together**. A reply draft does not copy
+recipients from the email it replies to, so set `--to` before you send it. At
+least one content field is required. Combined recipients cannot exceed 50.
 
 **Flags:** `--inbox_id <id>` — required in non-interactive mode
 

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

@@ -21,11 +21,13 @@ Detailed flag specifications for `resend webhooks` commands.
 | `--endpoint <url>` | string | Yes (non-interactive) | HTTPS webhook URL |
 | `--events <events...>` | string[] | Yes (non-interactive) | Event types or `all` |
 
-**All 19 events:**
+**All 37 events:**
 - Email: `email.sent`, `email.delivered`, `email.delivery_delayed`, `email.bounced`, `email.complained`, `email.opened`, `email.clicked`, `email.failed`, `email.scheduled`, `email.suppressed`, `email.received`
-- Contact: `contact.created`, `contact.updated`, `contact.deleted`
+- Contact: `contact.created`, `contact.updated`, `contact.deleted`, `contact.topics.updated`
 - Domain: `domain.created`, `domain.updated`, `domain.deleted`
 - Suppression: `suppression.added`, `suppression.removed`
+- Topic: `topic.created`, `topic.updated`, `topic.deleted`
+- Inbox (beta): `inbox.created`, `inbox.updated`, `inbox.deleted`, `inbox.thread.created`, `inbox.email.received`, `inbox.email.sent`, `inbox.thread.folder.updated`, `inbox.thread.assigned`, `inbox.thread.unassigned`, `inbox.thread.labels.updated`, `inbox.draft.created`, `inbox.draft.updated`, `inbox.draft.sent`, `inbox.draft.deleted`
 
 **Output includes `signing_secret`.** `webhooks get` returns it again.