Create a swarm
A swarm is an authoring container holding DEFAULTS for the journeys 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.
Response
The created swarm.
An authoring container for journeys. It holds DEFAULTS, not execution state — launching happens per journey.
Default fan-out for journeys authored under this container.
Epoch milliseconds.
Epoch milliseconds.

