Update a swarm
Changes the container’s DEFAULTS. Goals already authored under it keep the values they were created with — this is not a cascade.
Authorizations
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
ID of the hosted project that contains the server.
Swarm ID, as returned by the project's swarm list.
Body
Fields to change.
Same tri-state as the goal patch (null clears), and the same rule that iterations (or its deprecated sessionsPerTarget alias, never both) and maxTurns travel together.
200200011 <= x <= 100Pre-rename spelling of iterations. Accepted until general availability; never alongside it.
1 <= x <= 1001 <= x <= 200Response
The updated swarm.
An authoring container for goals. It holds DEFAULTS, not execution state — launching happens per goal.
Default fan-out for goals authored under this container.
Sessions run against EACH target. Total sessions = targets x this.
Pre-rename spelling of iterations, emitted alongside it until general availability.
Epoch milliseconds.
Epoch milliseconds.
Whether prerequisite setup may create or modify workspace data before sessions run. Defaults to false.

