Create a swarm
A swarm is an authoring container holding DEFAULTS for the goals made under it. Creating one starts nothing.
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.
Headers
Retry-safe create key. Replaying the SAME key with the SAME body returns the original resource instead of creating a second one; reusing it with a DIFFERENT body is a 409.
Path Parameters
ID of the hosted project that contains the server.
Body
The swarm to create.
- Option 1
- Option 2
Send iterations or its deprecated sessionsPerTarget alias — exactly one of the two.
2001 <= x <= 1001 <= x <= 20020001Pre-rename spelling of iterations. Accepted until general availability; never alongside it.
1 <= x <= 100Response
The created 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.

