API Reference

Episodes API

Track agent experiences as episodes.

Start Episode

POST /v1/episodes
{
  "userId": "user-123",
  "episodeType": "debugging",
  "title": "Fixing auth bug",
  "domain": "security",
  "complexity": 7
}

PUT /v1/episodes/:id/action
{
  "action": "Reviewed JWT middleware",
  "outcome": "partial",
  "reasoning": "Found config issue"
}

PUT /v1/episodes/:id/complete
{
  "success": true,
  "qualityScore": 8,
  "keyInsights": ["JWT expiry was 5 min instead of 1 hour"]
}

Completing an episode creates memories from the episode summary and key insights.