resend-cli 2.22.0-preview-inboxes.2 → 2.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend-cli",
-  "version": "2.22.0-preview-inboxes.2",
+  "version": "2.23.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.28.1-preview-inboxes.1"
+    "resend": "6.31.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.19.0"
+  version: "2.15.0"
   homepage: https://resend.com/docs/cli-agents
   source: https://github.com/resend/resend-cli
   openclaw:
@@ -59,7 +59,6 @@ references:
   - references/logs.md
   - references/careers.md
   - references/suppressions.md
-  - references/inboxes.md
   - references/webhooks.md
   - references/auth.md
   - references/workflows.md
@@ -135,9 +134,9 @@ Auth resolves: `RESEND_API_KEY` env > config file (`resend login --key`). Use `-
 | `emails receiving` | list, get, attachments, forward, listen |
 | `domains` | create, verify, get, claim, update, delete, list |
 | `logs` | list, get, open |
+| `usage` | Show account-level usage and quota limits (emails, contacts, segments, broadcasts, AI credits, automation runs, domains, rate limit) |
 | `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 |
 | `api-keys` | create, list, update, delete |
 | `automations` | create, get, list, update, delete, duplicate, stop, open, runs |
 | `events` | create, get, list, update, delete, send, open |
@@ -223,7 +222,6 @@ resend doctor -q
 - **Viewing API request logs** → [references/logs.md](references/logs.md)
 - **Browsing or applying to jobs at Resend** → [references/careers.md](references/careers.md)
 - **Managing the suppression list** (beta) → [references/suppressions.md](references/suppressions.md)
-- **Managing inboxes and received email** (beta) → [references/inboxes.md](references/inboxes.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/webhooks.md

@@ -21,11 +21,12 @@ 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 23 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`
 
 **Output includes `signing_secret`.** `webhooks get` returns it again.
 

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

@@ -1,349 +0,0 @@
-# inboxes
-
-Detailed flag specifications for `resend inboxes` commands.
-
-> **Beta:** Inboxes is a pre-GA feature gated per account. Commands appear in
-> `--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
-are rejected.
-
----
-
-## inboxes create
-
-Create a new inbox at one of your verified domains.
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--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 |
-
-**Output:** `{"object":"inbox","id":"<uuid>","name":"<name>","email_address":"<address>","domain_id":"<uuid>","forwarding_address":"<address>"|null,"unread":0,"created_at":"<date>"}`
-
----
-
-## inboxes list
-
-List all inboxes (default subcommand — `resend inboxes` alone runs it).
-
-| Flag | Type | Default | Description |
-|------|------|---------|-------------|
-| `--limit <n>` | number | 10 | Max results, 1-100 |
-| `--after <cursor>` | string | — | Forward pagination cursor (an inbox ID) |
-| `--before <cursor>` | string | — | Backward pagination cursor (an inbox ID) |
-
-**Alias:** `ls`
-
-**Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","name":"<name>"|null,"email_address":"<address>","unread":0,"last_received":"<date>"|null}]}`
-
----
-
-## inboxes get
-
-Retrieve a single inbox.
-
-**Argument:** `<id>` — inbox UUID (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}`
-
----
-
-## inboxes update
-
-Update an inbox's name or friendly name. At least one option is required.
-The email address cannot be changed after creation.
-
-**Argument:** `<id>` — inbox UUID
-
-| Flag | Type | Description |
-|------|------|-------------|
-| `--name <name>` | string | New inbox name (max 64 chars) |
-| `--friendly_name <name>` | string | New name used when sending from this inbox |
-
-**Output:** `{"object":"inbox","id":"<uuid>"}`
-
----
-
-## inboxes threads list
-
-List threads in an inbox (default subcommand of `resend inboxes threads`).
-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 |
-| `--label <label_id>` | string | — | Filter by label **UUID** (not name); repeat for multiple |
-| `--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,"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.
-
-**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":[{"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 update
-
-Mark a thread read/unread, move it, or apply a label. At least one option is
-required.
-
-**Flags:** `--inbox_id <id> --thread_id <id>` — required in non-interactive mode
-
-| Flag | Type | Description |
-|------|------|-------------|
-| `--read` | boolean | Mark every message in the thread as read |
-| `--unread` | boolean | Mark every message in the thread as unread |
-| `--folder <folder>` | string | Move to one of `inbox`, `archive`, `spam`, `trash` (`sent` is not a valid target) |
-| `--label_id <label_id>` | string | Apply this label (UUID) to the thread |
-
-**Output:** `{"object":"inbox_thread","id":"<uuid>","subject":"<subject>"|null,"folder":"<folder>","labels":[],"read":true}`
-
----
-
-## inboxes threads delete
-
-Delete a thread and all of its messages.
-
-**Flags:** `--inbox_id <id> --thread_id <id>` — required in non-interactive mode
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--yes` | boolean | Yes (non-interactive) | Skip confirmation |
-
-**Alias:** `rm`
-
-**Output:** `{"object":"inbox_thread","id":"<uuid>","deleted":true}`
-
----
-
-## 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,"message_id":"<message-id>"|null,"html":"<html>"|null,"text":"<text>"|null,"attachments":[{"id":"<id>","filename":"<name>"|null,"size":123}],"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.
-
-**Flags:** `--inbox_id <id> --thread_id <id> --email_id <id>` — required in
-non-interactive mode; the email ID comes from `inboxes threads get`
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--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>"}`
-
----
-
-## inboxes threads emails forward
-
-Forward an email to other recipients from the inbox address.
-
-**Flags:** `--inbox_id <id> --thread_id <id> --email_id <id>` — required in non-interactive mode
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--to <address>` | string | Yes | Recipient; repeat the flag 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>"}`
-
----
-
-## inboxes labels list
-
-List all labels in an inbox (not paginated; default subcommand of
-`resend inboxes labels`). Use label IDs with `threads update --label_id` and
-`threads list --label`.
-
-**Flags:** `--inbox_id <id>` — required in non-interactive mode
-
-**Alias:** `ls`
-
-**Output:** `{"object":"list","data":[{"id":"<uuid>","name":"<name>","color":"<color>","created_at":"<date>"}]}`
-
----
-
-## inboxes labels create
-
-Create a label. An inbox can have up to 100 labels.
-
-**Flags:** `--inbox_id <id>` — required in non-interactive mode
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--name <name>` | string | Yes (non-interactive) | Label name, max 64 characters |
-| `--color <color>` | string | No | One of `cyan`, `teal`, `grass`, `lime`, `yellow`, `orange`, `iris`, `plum`, `crimson`, `bronze`, `mauve` (random when omitted) |
-
-**Output:** `{"object":"inbox_label","id":"<uuid>","name":"<name>","color":"<color>","created_at":"<date>"}`
-
----
-
-## inboxes labels update
-
-Update a label's name or color. At least one option is required.
-
-**Flags:** `--inbox_id <id> --label_id <id>` — required in non-interactive mode
-
-| Flag | Type | Description |
-|------|------|-------------|
-| `--name <name>` | string | New label name |
-| `--color <color>` | string | New label color (same choices as create) |
-
-**Output:** `{"object":"inbox_label","id":"<uuid>"}`
-
----
-
-## inboxes labels delete
-
-Delete a label. It is removed from every thread that has it.
-
-**Flags:** `--inbox_id <id> --label_id <id>` — required in non-interactive mode
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--yes` | boolean | Yes (non-interactive) | Skip confirmation |
-
-**Alias:** `rm`
-
-**Output:** `{"object":"inbox_label","id":"<uuid>","deleted":true}`
-
----
-
-## inboxes drafts list
-
-List drafts in an inbox (default subcommand of `resend inboxes drafts`).
-
-**Flags:** `--inbox_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 (a draft ID) |
-| `--before <cursor>` | string | — | Backward pagination cursor (a draft ID) |
-
-**Alias:** `ls`
-
-**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.
-
-**Flags:** `--inbox_id <id>` — required in non-interactive mode
-
-| Flag | Type | Description |
-|------|------|-------------|
-| `--to <address>` | string | Recipient; repeat for multiple |
-| `--cc <address>` | string | Cc; repeat for multiple |
-| `--bcc <address>` | string | Bcc; repeat for multiple |
-| `--subject <subject>` | string | Draft subject |
-| `--text <text>` | string | Plain text body |
-| `--html <html>` | string | HTML body |
-| `--thread_id <thread_id>` | string | Thread to reply to (pairs with `--reply_to_email_id`) |
-| `--reply_to_email_id <email_id>` | string | Email the draft replies to (pairs with `--thread_id`) |
-
-**Output:** `{"object":"inbox_draft","id":"<uuid>","type":"standalone|reply","to":["<address>"]|null,"cc":[],"bcc":[],"subject":"<subject>"|null,"html":"<html>"|null,"text":"<text>"|null,"thread_id":"<uuid>"|null,"reply_to_email_id":"<uuid>"|null,"email_id":null,"created_at":"<date>","updated_at":"<date>"}`
-
----
-
-## inboxes drafts get
-
-Retrieve a draft, including its full body.
-
-**Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
-
-**Output:** same shape as `drafts create`.
-
----
-
-## inboxes drafts update
-
-Update a draft's recipients, subject, or body. At least one option is
-required; provided fields replace existing values. Same flags as
-`drafts create` minus `--thread_id`/`--reply_to_email_id`.
-
-**Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
-
-**Output:** same shape as `drafts create`.
-
----
-
-## inboxes drafts delete
-
-Delete a draft.
-
-**Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--yes` | boolean | Yes (non-interactive) | Skip confirmation |
-
-**Alias:** `rm`
-
-**Output:** `{"object":"inbox_draft","id":"<uuid>","deleted":true}`
-
----
-
-## inboxes drafts send
-
-Send a draft from the inbox address. The draft must have recipients and a
-body.
-
-**Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
-
-**Output:** `{"object":"inbox_draft","id":"<uuid>","thread_id":"<uuid>","email_id":"<uuid>"}`
-
----
-
-## inboxes delete
-
-Delete an inbox. Its threads and messages are removed and the address stops
-receiving email.
-
-**Argument:** `<id>` — inbox UUID
-
-| Flag | Type | Required | Description |
-|------|------|----------|-------------|
-| `--yes` | boolean | Yes (non-interactive) | Skip confirmation |
-
-**Alias:** `rm`
-
-**Output:** `{"object":"inbox","id":"<uuid>","deleted":true}`