Skip to main content
GET
Get swarm run insights

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

projectId
string
required

ID of the hosted project that contains the server.

swarmRunId
string
required

Swarm run ID — the opaque group id shared by every run of one co-launched swarm. Returned on every run in the swarm run.

Response

The swarm run's insights.

Model analysis over a whole swarm run — the batch of sibling goal runs launched together. Produced asynchronously — POLL this rather than re-requesting, because a second request SPENDS again.

swarmRunId
string
required
status
enum<string>
required
Available options:
pending,
completed,
failed
insights
object | null
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.

discovery
object | null
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.

errorCode
string | null
required
errorMessage
string | null
required
updatedAt
number
required

Epoch milliseconds.