resend-cli 2.17.1 → 2.19.0
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.
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "resend-cli",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.19.0",
|
|
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.
|
|
49
|
+
"resend": "6.26.0"
|
|
50
50
|
},
|
|
51
51
|
"pkg": {
|
|
52
52
|
"scripts": [
|
|
@@ -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.
|
|
16
|
+
version: "2.11.0"
|
|
17
17
|
homepage: https://resend.com/docs/cli-agents
|
|
18
18
|
source: https://github.com/resend/resend-cli
|
|
19
19
|
openclaw:
|
|
@@ -87,17 +87,7 @@ npm install -g resend-cli
|
|
|
87
87
|
brew install resend/cli/resend
|
|
88
88
|
```
|
|
89
89
|
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
```bash
|
|
93
|
-
# macOS / Linux
|
|
94
|
-
curl -fsSL https://resend.com/install.sh | bash
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
```powershell
|
|
98
|
-
# Windows PowerShell
|
|
99
|
-
irm https://resend.com/install.ps1 | iex
|
|
100
|
-
```
|
|
90
|
+
Other install methods (installer scripts for macOS, Linux, and Windows) are documented at [resend.com/docs/cli](https://resend.com/docs/cli).
|
|
101
91
|
|
|
102
92
|
After installing, verify:
|
|
103
93
|
```bash
|
|
@@ -122,7 +112,7 @@ The CLI auto-detects non-TTY environments and outputs JSON — no `--json` flag
|
|
|
122
112
|
|
|
123
113
|
## Authentication
|
|
124
114
|
|
|
125
|
-
Auth resolves:
|
|
115
|
+
Auth resolves: `RESEND_API_KEY` env > config file (`resend login --key`). Use `--profile` or `RESEND_PROFILE` for multi-profile.
|
|
126
116
|
|
|
127
117
|
**Credential safety:**
|
|
128
118
|
- Never write a literal API key into a command, script, or file — it ends up in shell history, logs, and transcripts. Reference the environment (`"$RESEND_API_KEY"`) or use a stored profile (`resend login`).
|
|
@@ -132,7 +122,6 @@ Auth resolves: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend lo
|
|
|
132
122
|
|
|
133
123
|
| Flag | Description |
|
|
134
124
|
|------|-------------|
|
|
135
|
-
| `--api-key <key>` | Override API key for this invocation |
|
|
136
125
|
| `-p, --profile <name>` | Select stored profile |
|
|
137
126
|
| `--json` | Force JSON output (auto in non-TTY) |
|
|
138
127
|
| `-q, --quiet` | Suppress spinners/status (implies `--json`) |
|
|
@@ -156,7 +145,7 @@ Auth resolves: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend lo
|
|
|
156
145
|
| `segments` | create, get, list, update, delete, contacts |
|
|
157
146
|
| `templates` | create, publish, duplicate, delete, list |
|
|
158
147
|
| `topics` | create, update, delete, list |
|
|
159
|
-
| `webhooks` | create, update, listen, delete, list |
|
|
148
|
+
| `webhooks` | create, update, listen, delete, list, events (list, get, attempts, replay) |
|
|
160
149
|
| `auth` | login, logout, switch, rename, remove |
|
|
161
150
|
| `whoami` / `doctor` / `update` / `open` / `commands` | Utility commands |
|
|
162
151
|
|
|
@@ -10,7 +10,7 @@ All errors exit with code `1` and output JSON to **stderr**:
|
|
|
10
10
|
|
|
11
11
|
| Code | Cause | Resolution |
|
|
12
12
|
|------|-------|------------|
|
|
13
|
-
| `auth_error` | No API key found from any source | Set `RESEND_API_KEY` env
|
|
13
|
+
| `auth_error` | No API key found from any source | Set `RESEND_API_KEY` env or run `resend login` |
|
|
14
14
|
| `missing_key` | `login` called non-interactively without `--key` | Pass `--key "$RESEND_API_KEY"` (from env/secret manager, never a literal) |
|
|
15
15
|
| `invalid_key_format` | API key does not start with `re_` | Use a valid Resend API key starting with `re_` |
|
|
16
16
|
| `validation_failed` | Resend API rejected the key during login | Verify the key exists and is active at resend.com/api-keys |
|
|
@@ -60,6 +60,66 @@ Detailed flag specifications for `resend webhooks` commands.
|
|
|
60
60
|
|
|
61
61
|
---
|
|
62
62
|
|
|
63
|
+
## webhooks events list
|
|
64
|
+
|
|
65
|
+
Lists the events Resend delivered to a webhook, most recent first.
|
|
66
|
+
|
|
67
|
+
**Argument:** `[webhookId]` — Webhook ID
|
|
68
|
+
|
|
69
|
+
| Flag | Type | Default | Description |
|
|
70
|
+
|------|------|---------|-------------|
|
|
71
|
+
| `--limit <n>` | number | 10 | Max results (1-100) |
|
|
72
|
+
| `--after <cursor>` | string | — | Forward pagination (an event ID) |
|
|
73
|
+
|
|
74
|
+
**No `--before`.** These endpoints paginate forward only.
|
|
75
|
+
|
|
76
|
+
**`status` values:** `pending`, `attempting`, `success`, `failed`.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## webhooks events get
|
|
81
|
+
|
|
82
|
+
**Arguments:** `[webhookId]` `[eventId]`
|
|
83
|
+
|
|
84
|
+
Returns the event with `next_attempt_at` and the `payload` that was sent to your endpoint.
|
|
85
|
+
`next_attempt_at` is `null` once the event reaches `success` or `failed`.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## webhooks events attempts
|
|
90
|
+
|
|
91
|
+
Lists the delivery attempts for one event, most recent first. Each attempt records the
|
|
92
|
+
`http_status_code` and `response` body your endpoint returned.
|
|
93
|
+
|
|
94
|
+
**Arguments:** `[webhookId]` `[eventId]`
|
|
95
|
+
|
|
96
|
+
| Flag | Type | Default | Description |
|
|
97
|
+
|------|------|---------|-------------|
|
|
98
|
+
| `--limit <n>` | number | 10 | Max results (1-100) |
|
|
99
|
+
| `--after <cursor>` | string | — | Forward pagination (an attempt ID) |
|
|
100
|
+
|
|
101
|
+
**Debugging a failed delivery:**
|
|
102
|
+
1. `resend webhooks events list <webhook-id>` — find the event
|
|
103
|
+
2. `resend webhooks events get <webhook-id> <event-id>` — see what we sent
|
|
104
|
+
3. `resend webhooks events attempts <webhook-id> <event-id>` — see what your endpoint returned
|
|
105
|
+
4. `resend webhooks events replay <webhook-id> <event-id>` — queue another delivery
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## webhooks events replay
|
|
110
|
+
|
|
111
|
+
Queues one more delivery of the event. Does not schedule automatic retries.
|
|
112
|
+
|
|
113
|
+
**Arguments:** `[webhookId]` `[eventId]`
|
|
114
|
+
|
|
115
|
+
The webhook must be enabled — re-enable it first with
|
|
116
|
+
`resend webhooks update <webhook-id> --status enabled`.
|
|
117
|
+
|
|
118
|
+
Returns `{"object":"webhook_event","id":"<event-id>"}` — no `type`, `status`,
|
|
119
|
+
or `payload` (use `events get` for those).
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
63
123
|
## webhooks listen
|
|
64
124
|
|
|
65
125
|
Start a local server that receives Resend webhook events in real time via a public tunnel URL.
|
|
@@ -7,11 +7,10 @@ Multi-step recipes for common Resend CLI tasks.
|
|
|
7
7
|
## 1. Initial Setup
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
# Install (pick one
|
|
10
|
+
# Install (pick one)
|
|
11
11
|
npm install -g resend-cli # npm
|
|
12
12
|
brew install resend/cli/resend # Homebrew (macOS / Linux)
|
|
13
|
-
|
|
14
|
-
irm https://resend.com/install.ps1 | iex # Windows PowerShell (executes a remote script)
|
|
13
|
+
# Other install methods: https://resend.com/docs/cli
|
|
15
14
|
|
|
16
15
|
# Authenticate — pass the key from an env var or secret manager;
|
|
17
16
|
# never type a literal key (it lands in shell history)
|