Swarms

Get a swarm

Changed on
get/projects/{projectId}/swarms/{swarmId}

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/projects/{projectId}/swarms/{swarmId}
  • Auth
    HTTP bearer

Response

The swarm.

idstring required
projectIdstring required
namestring required
descriptionstring nullable required
environmentIdsstring[] required

Default fan-out for goals authored under this container.

iterationsinteger nullable required

Sessions run against EACH target. Total sessions = targets x this.

sessionsPerTargetinteger nullable required

Pre-rename spelling of iterations, emitted alongside it until general availability.

maxTurnsinteger nullable required
setupWritesboolean

Whether prerequisite setup may create or modify workspace data before sessions run. Defaults to false.

createdAtnumber required

Epoch milliseconds.

updatedAtnumber required

Epoch milliseconds.

Changes

  • 561e4fd0dfa2Revision changes
    • info

      response property sessionsPerTarget deprecated

    • info

      added the required property to the response with the status

  • bc9863625ac8Revision changes
    • info

      added the optional property to the response with the status