Sign in
Swarm insights

Get swarm run 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}/swarm-runs/{swarmRunId}/insights

Response

The swarm run's insights.

swarmRunIdstring 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.

Changes