resend-cli 2.17.0 → 2.18.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.17.0",
3
+ "version": "2.18.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.23.0"
49
+ "resend": "6.25.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.8.0"
16
+ version: "2.10.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
- **Install script** — note: these download and execute a remote script. Prefer npm or Homebrew when available.
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: `--api-key` flag > `RESEND_API_KEY` env > config file (`resend login --key`). Use `--profile` or `RESEND_PROFILE` for multi-profile.
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) |
160
149
  | `auth` | login, logout, switch, rename, remove |
161
150
  | `whoami` / `doctor` / `update` / `open` / `commands` | Utility commands |
162
151
 
@@ -40,6 +40,7 @@ Interactive mode walks through every question in the job's application form; fla
40
40
  **Notes:**
41
41
  - Applying twice with the same email fails with `apply_error` ("An application has already been submitted...").
42
42
  - The resume is required by the API for every position.
43
+ - Yes/no questions (`Boolean` fields on the job posting) take `true` or `false` via `--field`; interactive mode prompts with a Yes/No select.
43
44
 
44
45
  **Example (non-interactive):**
45
46
  ```bash
@@ -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, pass `--api-key`, or run `resend login` |
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,51 @@ 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
+
106
+ ---
107
+
63
108
  ## webhooks listen
64
109
 
65
110
  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 — prefer a package manager)
10
+ # Install (pick one)
11
11
  npm install -g resend-cli # npm
12
12
  brew install resend/cli/resend # Homebrew (macOS / Linux)
13
- curl -fsSL https://resend.com/install.sh | bash # install script (executes a remote script)
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)