Swarms
Get a journey
get/projects/{projectId}/goals/{goalId}
Response
The goal.
idstring required
projectIdstring required
namestring required
goalstring required
What the persona is trying to accomplish. This drives the whole run.
personaIdstring required
swarmIdstring nullable required
The swarm container this goal was authored under. Provenance only — nothing resolves through it at run time, and a goal created outside a swarm has none.
environmentIdsstring[] required
Environments this goal fans out across. EMPTY on a host-pinned goal — that is a different execution model, not a goal with no targets.
serverAttachmentIdstring
Legacy host-pinned grounding. Absent on an environment-based goal.
iterationsinteger nullable required
Sessions run against EACH target. Total sessions = targets × this.
maxTurnsinteger nullable required
setupWritesboolean
Whether prerequisite setup may create or modify workspace data before sessions run. Defaults to false.
createdAtnumber required
Epoch milliseconds.
updatedAtnumber required
Epoch milliseconds.