koala73/worldmonitor · error · Error

[pushBatchAction] RESEND_API_KEY not set

Error message

[pushBatchAction] RESEND_API_KEY not set

What it means

Configuration gate at the top of pushBatchAction: process.env.RESEND_API_KEY is unset on the Convex deployment. The action pushes a contact batch to a Resend segment, so it fails fast before any lease or state revalidation.

Source

Thrown at convex/broadcast/waveRuns.ts:1136

            error: `failure rate ${(failureRate * 100).toFixed(2)}% exceeds ${(FAILURE_RATE_THRESHOLD * 100).toFixed(0)}% threshold`,
          }
        : {}),
    });
    return { ok: true as const, runFailed: exceeded };
  },
});

export const pushBatchAction = internalAction({
  args: {
    runId: v.string(),
    batchN: v.number(),
  },
  handler: async (
    ctx,
    { runId, batchN },
  ): Promise<{ ok: boolean; reason?: string }> => {
    const apiKey = process.env.RESEND_API_KEY;
    if (!apiKey) throw new Error("[pushBatchAction] RESEND_API_KEY not set");

    // Lease + state revalidation.
    const info = await ctx.runQuery(
      internal.broadcast.waveRuns._resumeBatchInfo,
      { runId },
    );
    if (!info) {
      console.warn(`[pushBatchAction] runId=${runId} not found; exiting`);
      return { ok: false, reason: "no-run" };
    }
    if (!info.configHoldsLease) {
      console.warn(`[pushBatchAction] runId=${runId} lost lease; exiting`);
      return { ok: false, reason: "lost-lease" };
    }
    const allowedStatuses: WaveRunStatus[] = ["segment-created", "pushing"];
    if (!allowedStatuses.includes(info.run.status)) {
      console.warn(
        `[pushBatchAction] runId=${runId} status=${info.run.status} not pushable; exiting`,

View on GitHub (pinned to eeab0a219f)

Solutions

1. Set RESEND_API_KEY in the Convex dashboard environment variables
2. Re-run the batch push after fixing the environment; batch state is resumable via the run's lease

When it happens

Trigger: Thrown at convex/broadcast/waveRuns.ts:1136 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of koala73/worldmonitor@eeab0a219f (2026-08-21). Data as JSON: /api/errors/8c5f0fbeb5a44691. Report an issue: GitHub.