MCmcpjam
Swarm insights

Get swarm run insights

Changed on

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

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • Auth
    HTTP bearer

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

  • bf355f10845cRevision changes
    • warning

      added the new AUTH_REQUIRED enum value to the response property for the response status

    • warning

      added the new AUTH_REQUIRED enum value to the response property for the response status

    • warning

      added the new AUTH_REQUIRED enum value to the response property for the response status

    • warning

      added the new AUTH_REQUIRED enum value to the response property for the response status

    • warning

      added the new AUTH_REQUIRED enum value to the response property for the response status

  • 561e4fd0dfa2Revision changes
    • info

      endpoint added