Helm (AI Agents)

Method	Path	Auth	Description
GET	/api/v1/agents	JWT	List agents
POST	/api/v1/agents	Admin	Create agent
GET	/api/v1/agents/{id}	JWT	Get agent
PUT	/api/v1/agents/{id}	Admin	Update agent
DELETE	/api/v1/agents/{id}	Admin	Delete agent

POST /api/v1/agents

curl -X POST http://localhost:8080/api/v1/agents \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Analyst",
    "model": "claude-sonnet-4-5-20250514",
    "system_prompt": "You are a financial analyst."
  }'

Response:

{
  "id": "analyst-abc123",
  "name": "Analyst",
  "provider": "anthropic",
  "model": "claude-sonnet-4-5-20250514",
  "system_prompt": "You are a financial analyst.",
  "enabled": true,
  "created_by": "user-id",
  "created_at": "2025-01-15T10:30:00Z"
}

PUT /api/v1/agents/{id}

Partial update: {"enabled": false} to disable, {"model": "claude-opus-4-20250514"} to change model.