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 goals. It holds DEFAULTS, not execution state — launching happens per goal.

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

Default fan-out for goals authored under this container.

iterations
integer | null
required

Sessions run against EACH target. Total sessions = targets x this.

sessionsPerTarget
integer | null
required
deprecated

Pre-rename spelling of iterations, emitted alongside it until general availability.

maxTurns
integer | null
required
createdAt
number
required

Epoch milliseconds.

updatedAt
number
required

Epoch milliseconds.

setupWrites
boolean

Whether prerequisite setup may create or modify workspace data before sessions run. Defaults to false.