Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-15140179507.6 KB

d3adfe49fbbf

Swarm insights

Request wave insights

Answers 202: generation is scheduled, not done. Poll the GET above rather than re-requesting.

SPENDS. This runs models on your organization's account and draws on the insightsPerDay ledger, which is SHARED with eval-run and user-testing insights — burning it here takes it from there too.

Three refusals, and they mean different things:

  • 429 with code: "RATE_LIMITED" and a short Retry-After — the per-minute burst brake. Wait seconds.
  • 429 naming insightsPerDay in details — the daily ledger. Retry-After counts to UTC midnight.
  • 403 — the feature is not available to your organization. Waiting will never help; collapsing this into the 429s would send someone who hit today's cap shopping for a plan they already have.
post/projects/{projectId}/waves/{waveId}/insights

Request body

forceboolean

Regenerate over a wave that already has insights. OFF by default because it SPENDS a second time against your organization's shared daily ledger — and the common cause of a repeated request is a caller that did not poll.

Response

Generation was scheduled.

waveIdstring required
projectIdstring required
status'pending' required