Build
Playground
Compose multiple agents into a swarm, choose how they collaborate, and watch them talk to each other.
Swarm
Agents run one after another; each builds on the previous output.
0
Sent as the top-level
img field. Use a publicly reachable URL.2
Agents
#1
#2
Add a task to run the swarm.
Nothing yet
Configure the swarm and your agents on the left, then click Run swarm to see them collaborate.
Request preview
POST /v1/swarm/completionscurl -X POST 'https://api.swarms.world/v1/swarm/completions' \
-H 'x-api-key: '"$SWARMS_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"name": "Untitled Swarm",
"swarm_type": "SequentialWorkflow",
"max_loops": 1,
"agents": [
{
"agent_name": "Researcher",
"model_name": "gpt-5.4-mini",
"role": "worker",
"system_prompt": "You research the topic deeply and provide structured findings.",
"temperature": 0.7,
"max_loops": 1,
"max_tokens": 8192
},
{
"agent_name": "Writer",
"model_name": "gpt-5.4-mini",
"role": "worker",
"system_prompt": "You take the research and craft a clear, well-structured response.",
"temperature": 0.7,
"max_loops": 1,
"max_tokens": 8192
}
]
}'