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

d3adfe49fbbf

Swarm insights

Get wave insights

Poll this after requesting insights. 404 means nobody asked — it is deliberately not an empty status: "none" body, so a caller in a polling loop cannot mistake "never requested" for "asked and still working".

get/projects/{projectId}/waves/{waveId}/insights

Response

The wave's insights.

waveIdstring required
status'pending' | 'completed' | 'failed' required
insightsobject nullable required

The DIRECTED lane: an explanation of the findings the deterministic pass already surfaced. null until generation completes. An opaque object — read it, do not pattern-match its internals.

discoveryobject nullable required

The DISCOVERY lane: what the model noticed unprompted. null while only the directed lane has finished, which is a normal intermediate state rather than a failure. Opaque, like insights.

errorCodestring nullable required
errorMessagestring nullable required
updatedAtnumber required

Epoch milliseconds.