Skip to main content
GET
Get a swarm

Authorizations

Authorization
string
header
required

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

projectId
string
required

ID of the hosted project that contains the server.

swarmId
string
required

Swarm ID, as returned by the project's swarm list.

Response

The swarm.

An authoring container for journeys. It holds DEFAULTS, not execution state — launching happens per journey.

id
string
required
projectId
string
required
name
string
required
description
string | null
required
environmentIds
string[]
required

Default fan-out for journeys authored under this container.

sessionsPerTarget
integer | null
required
maxTurns
integer | null
required
createdAt
number
required

Epoch milliseconds.

updatedAt
number
required

Epoch milliseconds.