Skip to main content
GET
Get wave 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.

waveId
string
required

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

Response

The wave's insights.

Model analysis over a whole wave. Produced asynchronously — POLL this rather than re-requesting, because a second request SPENDS again.

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