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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/dist/cli.cjs +187 -189
  2. package/package.json +2 -2
  3. package/skills/resend-cli/SKILL.md +1 -1
  4. package/skills/resend-cli/references/inboxes.md +47 -41
  5. package/skills/resend-cli/references/webhooks.md +2 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "resend-cli",
3
- "version": "2.22.0-preview-inboxes.0",
3
+ "version": "2.22.0-preview-inboxes.2",
4
4
  "description": "The official CLI for Resend",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -46,7 +46,7 @@
46
46
  "esbuild": "0.28.1",
47
47
  "esbuild-wasm": "0.28.0",
48
48
  "picocolors": "1.1.1",
49
- "resend": "6.28.1-preview-inboxes.0"
49
+ "resend": "6.28.1-preview-inboxes.1"
50
50
  },
51
51
  "pkg": {
52
52
  "scripts": [
package/skills/resend-cli/SKILL.md CHANGED
@@ -13,7 +13,7 @@ metadata:
13
13
  author: resend
14
14
  # Skill version is independent from the CLI/package.json version —
15
15
  # bump it on skill content changes, not CLI releases.
16
- version: "2.17.0"
16
+ version: "2.19.0"
17
17
  homepage: https://resend.com/docs/cli-agents
18
18
  source: https://github.com/resend/resend-cli
19
19
  openclaw:
package/skills/resend-cli/references/inboxes.md CHANGED
@@ -19,8 +19,9 @@ Create a new inbox at one of your verified domains.
19
19
 
20
20
  | Flag | Type | Required | Description |
21
21
  |------|------|----------|-------------|
22
- | `--email-address <address>` | string | Yes (non-interactive) | Address for the inbox, e.g. `support@yourdomain.com` |
22
+ | `--email_address <address>` | string | Yes (non-interactive) | Address for the inbox, e.g. `support@yourdomain.com` |
23
23
  | `--name <name>` | string | No | Inbox name shown in the dashboard (max 64 chars) |
24
+ | `--friendly_name <name>` | string | No | Name used when sending from this inbox, e.g. `Ada from Support` |
24
25
  | `--forwarding` | boolean | No | Enable forwarding — received emails are also forwarded to a generated forwarding address |
25
26
 
26
27
  **Output:** `{"object":"inbox","id":"<uuid>","name":"<name>","email_address":"<address>","domain_id":"<uuid>","forwarding_address":"<address>"|null,"unread":0,"created_at":"<date>"}`
@@ -55,13 +56,15 @@ Retrieve a single inbox.
55
56
 
56
57
  ## inboxes update
57
58
 
58
- Update an inbox's name. The email address cannot be changed after creation.
59
+ Update an inbox's name or friendly name. At least one option is required.
60
+ The email address cannot be changed after creation.
59
61
 
60
62
  **Argument:** `<id>` — inbox UUID
61
63
 
62
- | Flag | Type | Required | Description |
63
- |------|------|----------|-------------|
64
- | `--name <name>` | string | Yes | New inbox name (max 64 chars) |
64
+ | Flag | Type | Description |
65
+ |------|------|-------------|
66
+ | `--name <name>` | string | New inbox name (max 64 chars) |
67
+ | `--friendly_name <name>` | string | New name used when sending from this inbox |
65
68
 
66
69
  **Output:** `{"object":"inbox","id":"<uuid>"}`
67
70
 
@@ -70,21 +73,23 @@ Update an inbox's name. The email address cannot be changed after creation.
70
73
  ## inboxes threads list
71
74
 
72
75
  List threads in an inbox (default subcommand of `resend inboxes threads`).
73
- Pages are fixed at 50 threads, newest activity first — there is no `--limit`.
76
+ Threads are ordered by newest activity first.
74
77
 
75
- **Flags:** `--inbox-id <id>` — required in non-interactive mode
78
+ **Flags:** `--inbox_id <id>` — required in non-interactive mode
76
79
 
77
80
  | Flag | Type | Default | Description |
78
81
  |------|------|---------|-------------|
79
82
  | `--folder <folder>` | string | `inbox` | One of `inbox`, `archive`, `spam`, `sent`, `trash` |
80
83
  | `--query <text>` | string | — | Search subject, sender, and label names |
81
84
  | `--from <sender>` | string | — | Filter by sender address or name |
82
- | `--label <labelId>` | string | — | Filter by label **UUID** (not name); repeat for multiple |
83
- | `--cursor <cursor>` | string | — | `next_cursor` from a previous response |
85
+ | `--label <label_id>` | string | — | Filter by label **UUID** (not name); repeat for multiple |
86
+ | `--limit <n>` | number | 10 | Max results, 1-100 |
87
+ | `--after <cursor>` | string | — | Forward pagination cursor (a thread ID) |
88
+ | `--before <cursor>` | string | — | Backward pagination cursor (a thread ID) |
84
89
 
85
90
  **Alias:** `ls`
86
91
 
87
- **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>"}]}`
92
+ **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>"}]}`
88
93
 
89
94
  ---
90
95
 
@@ -93,9 +98,9 @@ Pages are fixed at 50 threads, newest activity first — there is no `--limit`.
93
98
  Retrieve a thread with every message inline, including `html` and `text`
94
99
  bodies. Use the message `id` values as the email ID for replies.
95
100
 
96
- **Flags:** `--inbox-id <id> --thread-id <id>` — required in non-interactive mode
101
+ **Flags:** `--inbox_id <id> --thread_id <id>` — required in non-interactive mode
97
102
 
98
- **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>"}]}}`
103
+ **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>"}]}`
99
104
 
100
105
  ---
101
106
 
@@ -104,14 +109,14 @@ bodies. Use the message `id` values as the email ID for replies.
104
109
  Mark a thread read/unread, move it, or apply a label. At least one option is
105
110
  required.
106
111
 
107
- **Flags:** `--inbox-id <id> --thread-id <id>` — required in non-interactive mode
112
+ **Flags:** `--inbox_id <id> --thread_id <id>` — required in non-interactive mode
108
113
 
109
114
  | Flag | Type | Description |
110
115
  |------|------|-------------|
111
116
  | `--read` | boolean | Mark every message in the thread as read |
112
117
  | `--unread` | boolean | Mark every message in the thread as unread |
113
118
  | `--folder <folder>` | string | Move to one of `inbox`, `archive`, `spam`, `trash` (`sent` is not a valid target) |
114
- | `--label-id <labelId>` | string | Apply this label (UUID) to the thread |
119
+ | `--label_id <label_id>` | string | Apply this label (UUID) to the thread |
115
120
 
116
121
  **Output:** `{"object":"inbox_thread","id":"<uuid>","subject":"<subject>"|null,"folder":"<folder>","labels":[],"read":true}`
117
122
 
@@ -121,7 +126,7 @@ required.
121
126
 
122
127
  Delete a thread and all of its messages.
123
128
 
124
- **Flags:** `--inbox-id <id> --thread-id <id>` — required in non-interactive mode
129
+ **Flags:** `--inbox_id <id> --thread_id <id>` — required in non-interactive mode
125
130
 
126
131
  | Flag | Type | Required | Description |
127
132
  |------|------|----------|-------------|
@@ -137,9 +142,9 @@ Delete a thread and all of its messages.
137
142
 
138
143
  Retrieve a single email from a thread.
139
144
 
140
- **Flags:** `--inbox-id <id> --thread-id <id> --email-id <id>` — required in non-interactive mode
145
+ **Flags:** `--inbox_id <id> --thread_id <id> --email_id <id>` — required in non-interactive mode
141
146
 
142
- **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>"}`
147
+ **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>"}`
143
148
 
144
149
  ---
145
150
 
@@ -148,7 +153,7 @@ Retrieve a single email from a thread.
148
153
  Reply to a specific email in a thread. The reply is sent from the inbox
149
154
  address to the sender of the original email.
150
155
 
151
- **Flags:** `--inbox-id <id> --thread-id <id> --email-id <id>` — required in
156
+ **Flags:** `--inbox_id <id> --thread_id <id> --email_id <id>` — required in
152
157
  non-interactive mode; the email ID comes from `inboxes threads get`
153
158
 
154
159
  | Flag | Type | Required | Description |
@@ -165,7 +170,7 @@ non-interactive mode; the email ID comes from `inboxes threads get`
165
170
 
166
171
  Forward an email to other recipients from the inbox address.
167
172
 
168
- **Flags:** `--inbox-id <id> --thread-id <id> --email-id <id>` — required in non-interactive mode
173
+ **Flags:** `--inbox_id <id> --thread_id <id> --email_id <id>` — required in non-interactive mode
169
174
 
170
175
  | Flag | Type | Required | Description |
171
176
  |------|------|----------|-------------|
@@ -181,14 +186,14 @@ Forward an email to other recipients from the inbox address.
181
186
  ## inboxes labels list
182
187
 
183
188
  List all labels in an inbox (not paginated; default subcommand of
184
- `resend inboxes labels`). Use label IDs with `threads update --label-id` and
189
+ `resend inboxes labels`). Use label IDs with `threads update --label_id` and
185
190
  `threads list --label`.
186
191
 
187
- **Flags:** `--inbox-id <id>` — required in non-interactive mode
192
+ **Flags:** `--inbox_id <id>` — required in non-interactive mode
188
193
 
189
194
  **Alias:** `ls`
190
195
 
191
- **Output:** `{"object":"list","has_more":false,"data":[{"id":"<uuid>","name":"<name>","color":"<color>","created_at":"<date>"}]}`
196
+ **Output:** `{"object":"list","data":[{"id":"<uuid>","name":"<name>","color":"<color>","created_at":"<date>"}]}`
192
197
 
193
198
  ---
194
199
 
@@ -196,7 +201,7 @@ List all labels in an inbox (not paginated; default subcommand of
196
201
 
197
202
  Create a label. An inbox can have up to 100 labels.
198
203
 
199
- **Flags:** `--inbox-id <id>` — required in non-interactive mode
204
+ **Flags:** `--inbox_id <id>` — required in non-interactive mode
200
205
 
201
206
  | Flag | Type | Required | Description |
202
207
  |------|------|----------|-------------|
@@ -211,7 +216,7 @@ Create a label. An inbox can have up to 100 labels.
211
216
 
212
217
  Update a label's name or color. At least one option is required.
213
218
 
214
- **Flags:** `--inbox-id <id> --label-id <id>` — required in non-interactive mode
219
+ **Flags:** `--inbox_id <id> --label_id <id>` — required in non-interactive mode
215
220
 
216
221
  | Flag | Type | Description |
217
222
  |------|------|-------------|
@@ -226,7 +231,7 @@ Update a label's name or color. At least one option is required.
226
231
 
227
232
  Delete a label. It is removed from every thread that has it.
228
233
 
229
- **Flags:** `--inbox-id <id> --label-id <id>` — required in non-interactive mode
234
+ **Flags:** `--inbox_id <id> --label_id <id>` — required in non-interactive mode
230
235
 
231
236
  | Flag | Type | Required | Description |
232
237
  |------|------|----------|-------------|
@@ -241,27 +246,28 @@ Delete a label. It is removed from every thread that has it.
241
246
  ## inboxes drafts list
242
247
 
243
248
  List drafts in an inbox (default subcommand of `resend inboxes drafts`).
244
- Opaque cursor pagination like threads — no `--limit`.
245
249
 
246
- **Flags:** `--inbox-id <id>` — required in non-interactive mode
250
+ **Flags:** `--inbox_id <id>` — required in non-interactive mode
247
251
 
248
- | Flag | Type | Description |
249
- |------|------|-------------|
250
- | `--cursor <cursor>` | string | `next_cursor` from a previous response |
252
+ | Flag | Type | Default | Description |
253
+ |------|------|---------|-------------|
254
+ | `--limit <n>` | number | 10 | Max results, 1-100 |
255
+ | `--after <cursor>` | string | — | Forward pagination cursor (a draft ID) |
256
+ | `--before <cursor>` | string | — | Backward pagination cursor (a draft ID) |
251
257
 
252
258
  **Alias:** `ls`
253
259
 
254
- **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>"}]}`
260
+ **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>"}]}`
255
261
 
256
262
  ---
257
263
 
258
264
  ## inboxes drafts create
259
265
 
260
- Create a standalone draft, or a reply draft when `--thread-id` and
261
- `--reply-to-email-id` are passed **together**. At least one content field is
266
+ Create a standalone draft, or a reply draft when `--thread_id` and
267
+ `--reply_to_email_id` are passed **together**. At least one content field is
262
268
  required.
263
269
 
264
- **Flags:** `--inbox-id <id>` — required in non-interactive mode
270
+ **Flags:** `--inbox_id <id>` — required in non-interactive mode
265
271
 
266
272
  | Flag | Type | Description |
267
273
  |------|------|-------------|
@@ -271,8 +277,8 @@ required.
271
277
  | `--subject <subject>` | string | Draft subject |
272
278
  | `--text <text>` | string | Plain text body |
273
279
  | `--html <html>` | string | HTML body |
274
- | `--thread-id <threadId>` | string | Thread to reply to (pairs with `--reply-to-email-id`) |
275
- | `--reply-to-email-id <emailId>` | string | Email the draft replies to (pairs with `--thread-id`) |
280
+ | `--thread_id <thread_id>` | string | Thread to reply to (pairs with `--reply_to_email_id`) |
281
+ | `--reply_to_email_id <email_id>` | string | Email the draft replies to (pairs with `--thread_id`) |
276
282
 
277
283
  **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>"}`
278
284
 
@@ -282,7 +288,7 @@ required.
282
288
 
283
289
  Retrieve a draft, including its full body.
284
290
 
285
- **Flags:** `--inbox-id <id> --draft-id <id>` — required in non-interactive mode
291
+ **Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
286
292
 
287
293
  **Output:** same shape as `drafts create`.
288
294
 
@@ -292,9 +298,9 @@ Retrieve a draft, including its full body.
292
298
 
293
299
  Update a draft's recipients, subject, or body. At least one option is
294
300
  required; provided fields replace existing values. Same flags as
295
- `drafts create` minus `--thread-id`/`--reply-to-email-id`.
301
+ `drafts create` minus `--thread_id`/`--reply_to_email_id`.
296
302
 
297
- **Flags:** `--inbox-id <id> --draft-id <id>` — required in non-interactive mode
303
+ **Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
298
304
 
299
305
  **Output:** same shape as `drafts create`.
300
306
 
@@ -304,7 +310,7 @@ required; provided fields replace existing values. Same flags as
304
310
 
305
311
  Delete a draft.
306
312
 
307
- **Flags:** `--inbox-id <id> --draft-id <id>` — required in non-interactive mode
313
+ **Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
308
314
 
309
315
  | Flag | Type | Required | Description |
310
316
  |------|------|----------|-------------|
@@ -321,7 +327,7 @@ Delete a draft.
321
327
  Send a draft from the inbox address. The draft must have recipients and a
322
328
  body.
323
329
 
324
- **Flags:** `--inbox-id <id> --draft-id <id>` — required in non-interactive mode
330
+ **Flags:** `--inbox_id <id> --draft_id <id>` — required in non-interactive mode
325
331
 
326
332
  **Output:** `{"object":"inbox_draft","id":"<uuid>","thread_id":"<uuid>","email_id":"<uuid>"}`
327
333
 
package/skills/resend-cli/references/webhooks.md CHANGED
@@ -21,10 +21,11 @@ Detailed flag specifications for `resend webhooks` commands.
21
21
  | `--endpoint <url>` | string | Yes (non-interactive) | HTTPS webhook URL |
22
22
  | `--events <events...>` | string[] | Yes (non-interactive) | Event types or `all` |
23
23
 
24
- **All 17 events:**
24
+ **All 19 events:**
25
25
  - Email: `email.sent`, `email.delivered`, `email.delivery_delayed`, `email.bounced`, `email.complained`, `email.opened`, `email.clicked`, `email.failed`, `email.scheduled`, `email.suppressed`, `email.received`
26
26
  - Contact: `contact.created`, `contact.updated`, `contact.deleted`
27
27
  - Domain: `domain.created`, `domain.updated`, `domain.deleted`
28
+ - Suppression: `suppression.added`, `suppression.removed`
28
29
 
29
30
  **Output includes `signing_secret`.** `webhooks get` returns it again.
30
31