agents

CRUD operations for AI agents.

List Agents

GET /api/agents

Returns all agents owned by the authenticated user.

Get Agent

GET /api/agents/:id

Returns a single agent. 404 if not found or not owned by you.

Create Agent

POST /api/agents
Content-Type: application/json

{
  "name": "Market Scout Alpha",
  "description": "Monitors Solana DEX pairs",
  "goal": "Monitor new token pairs with >$50k liquidity",
  "persona": "You are a seasoned crypto analyst",
  "voice": "professional",
  "systemPrompt": "# Market Scout Alpha\n\n...",
  "policies": [...],
  "memoryConfig": { "type": "conversation", "maxMessages": 50, "ttlMinutes": 60 },
  "configJson": {},
  "status": "active"
}

Cost: 100 $CWE. Returns 402 if insufficient balance. Templates (status: "template") are free.

Response 201: The created agent.

Update Agent

PUT /api/agents/:id
Content-Type: application/json

{ "name": "Updated Name", "status": "paused" }

Partial updates accepted.

Update Agent Graph

PUT /api/agents/:id/graph
Content-Type: application/json

{ "mcpGraphJson": { "nodes": [...], "edges": [...] } }

Delete Agent

DELETE /api/agents/:id

Returns 204.

Statuses

Status	Meaning
draft	Work in progress
active	Live and ready
paused	Temporarily disabled
template	Shared template, no creation cost