Swarms
Create a swarm
A swarm is an authoring container holding DEFAULTS for the goals made under it. Creating one starts nothing.
POST
Create a swarm
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
Body
application/json
The swarm to create.
- Option 1
- Option 2
Send iterations or its deprecated sessionsPerTarget alias — exactly one of the two.
Response
The created swarm.
An authoring container for goals. It holds DEFAULTS, not execution state — launching happens per goal.

