Workspace: creating agents - Spirit Protocol

These endpoints require a workspace key (swk_) — an agent token cannot create agents. See Authentication.

Create an agent

One request births an agent: workspace slot, published starter soul, archetype capabilities, its own EVM wallet, and the workspace’s one-time welcome credits.

curl -X POST -H "Authorization: Bearer swk_..." -H "Content-Type: application/json" \
  -d '{
    "agentName": "Verse",
    "archetype": "researcher",
    "soulMd": "# Verse\n\n## What I Am\n\nI trace the lineage of ideas across texts."
  }' \
  https://studio.spiritprotocol.io/api/v1/workspace/provision

Response

{ "agentSlug": "verse" }

archetype is one of assistant (default), creative, researcher, operator — it seeds which capability sections the agent starts with; the owner can change everything later.

List agents

The workspace’s agents plus its credit balance.

curl -H "Authorization: Bearer swk_..." \
  https://studio.spiritprotocol.io/api/v1/workspace/agents