resend-cli

Resend CLI の運用

メンテナンスされている CLI を直接使用してください。その commands の出力により、重複していた旧コマンド一覧、タスクルーター、Python ラッパーは不要になります。古いフラグの複製ではなく、タスク固有の意図と検証を維持してください。

確認と対象範囲の設定

resend --version
resend --json commands
resend emails send --help
resend --json -q doctor

doctor はアカウントを検査できますが、完全にオフラインで実行できるバージョン確認コマンドではありません。利用可能な実行手段がすでに認可済みのコネクターである場合は、代わりにそれを使用してください。読み取り専用の検査を実行するためだけに、インストール、ログイン、プロファイルの変更、認証情報の適用範囲の拡大を行わないでください。キーを出力せずに、有効なアカウント／プロファイルとトークンのスコープを確認してください。引数の --api-key よりも、シークレットストアの環境変数または保存済みのプロファイルを優先してください。使用した CLI のバージョンとヘルプを記録してください。

範囲が限定された自動化では、必要な引数をすべて渡して --json -q を指定し、標準出力、標準エラー出力、終了ステータスを別々に取得してください。現在のマシン出力では、成功時は標準出力に JSON が、エラー時は標準エラー出力に出力されます。警告が出る場合もあります。終了コードがゼロであることと、期待される結果が有効であることの両方が必要です。ストリームリスナーは、範囲が限定された JSON コマンドではありません。出力チャネルを連結して、結果が 1 つの JSON ドキュメントであるかのように扱わないでください。フラグや出力形式が異なる場合は、インストール済みのヘルプを確認してください。

操作を選択

意図	操作手段	検証
1 通のトランザクションメール	emails send	ID を保存し、後で配信結果を確認
内容の異なるトランザクションメール	emails batch	ペイロードを固定し、返された ID を対応付け、失敗を照合
ホストされたコンテンツ	templates と emails send --template	公開済みのバージョン、変数、送信者の既定値
マーケティングキャンペーン	broadcasts、segments、topics	対象者／同意を正確に確認し、プレビュー、送信ステータスを確認
送信者／受信の設定	domains	返された DNS レコードと検証済みの機能
受信したメッセージ	emails receiving	検証済みのイベント後に完全なコンテンツ／添付ファイルを取得
イベント駆動型のメールシーケンス	automations、events	無効状態のドラフト、承認済みの有効化、実行結果
認証情報／イベント配信の設定	api-keys、webhooks	最小権限、シークレットの保存、テスト配信

正確なフラグは、この操作一覧ではなく、resend commands とサブコマンドのヘルプで確認してください。キャッシュ済みのカタログに記載がないという理由だけで、その操作はサポートされていないと判断しないでください。関連する CLI の機能不足を確認した後に限り、API／SDK を使用してください。

ホストされたテンプレートの送信

現在の emails send は --template と --var をサポートしています。ホストされたテンプレートを送信するためだけに、REST に切り替える必要はありません。

resend --json -q emails send \
  --template "$TEMPLATE_ID" --to [email protected] \
  --var CUSTOMER_NAME=Taylor --idempotency-key "$SEND_KEY" --dry-run

実際に公開済みのテンプレートと、その変数定義を最初に確認してください。テンプレートで定義されていない場合は、送信者／件名を指定し、上書き内容を検証してください。現在の CLI の --var 値は文字列です。数値型の変数が重要な場合は、適切な型付きの SDK／API ペイロードを使用してください。テンプレートと本文の直接指定フラグを併用しないでください。確認済みの CLI では、テンプレートへの添付ファイル追加も拒否されます。CLI の制限が、すべての API 操作にも当てはまるとは限りません。

ドライランで検証されるのはローカルの入力のみであり、テンプレートの存在、公開状態、権限、受信者の認可、配信は検証されません。ペイロードを確認し、認可された送信を行う場合に限り --dry-run を削除してください。その際も、同じ内容と操作 ID を維持してください。

変更と再試行の規律

送信前に、実際の宛先、アカウント、内容、添付ファイル、スケジュール／タイムゾーン、対象範囲を確認してください。下書きやプレビューは送信の許可を意味しません。一斉送信やカスタムイベントの発火は、多数の宛先に配信される可能性があります。

メール／バッチ送信の前に、一意の冪等性キーと正確なリクエストを永続化してください。同じキーを使った同一操作の再試行は、プロバイダーが定める期間内（現在は24時間）に限ります。内容を変更した場合は、新しい操作として扱います。期間を過ぎたら再実行せずに照合してください。また、メールの冪等性保証を他のエンドポイントに適用しないでください。タイムアウトは、未送信ではなく、受理されたものの確認応答がないことを意味する場合があります。

ネイティブの --dry-run は特定のコマンド（現在はメール送信と一斉送信の作成）のみで利用でき、すべての変更操作に対応しているわけではありません。ヘルプを確認してください。ライブ呼び出しでプレビューを模倣してはいけません。プレビューに対応していない場合は、変更操作を呼び出さずに、意図したペイロードと宛先をローカルでレンダリングしてください。

バッチ処理、ドメイン、サブスクリプション、受信、ストリーム、Automations については、運用上の確認事項を参照してください。ID、確認済みの状態、不明な結果、次に必要な証拠を報告してください。受理されたことは配信済みであることを意味せず、配信が記録されても受信トレイに届いたことや人が読んだことの証明にはなりません。

情報源と評価

2026-09-13 に、公式 CLI、送信ソース、API ドキュメントを基に確認しました。評価ケース：evals/scenarios.json。これらの評価にはエージェントのトレースレビューが必要です。これらが存在するからといって、ライブアカウントへのアクセスや送信が行われるわけではありません。