Reference

API Reference

Flat, searchable list of every endpoint, auto-generated from the platform's OpenAPI schema. For an interactive "try it" UI, see the API Explorer.

Key endpoints

Curated list of the most-used endpoints. Items taggednewlanded in the latest release.

Process
  • post/api/sdk/process
  • post/api/sdk/process/stream
Memory & history
  • get/api/sdk/memory/{user_id}
  • post/api/sdk/memory/{user_id}new
  • get/api/sdk/history/{user_id}
  • delete/api/sdk/history/{user_id}
Tasks
  • get/api/tasks
  • post/api/tasks/{id}/completenew
  • post/api/tasks/{id}/snoozenew
Analytics
  • get/api/analytics/behavior-score

Process response shape

POST /api/sdk/process returns the full behavioral envelope. Below is the shape of the fields that have moved or been added in the current release — the rest of the response (memory, safety, proactive, analysis) is unchanged.

json
{
  "user": {
    "mood": 0.42,
    "energy": 0.55,
    "trust": 0.71,
    "sentiment": 0.48,
    "grudge": 0.32,
    "familiarity": 0.18,
    "interaction_count": 14
  },

  "context": {
    "tone_grudge_modifier": "cautious",
    "tone_dependence_modifier": ""
  },

  "timing": {
    "delay_ms": 4250,
    "mode": "conversational",
    "reason": "emotional_weight + conversation_pace",
    "components": [
      { "label": "base",                 "delta_ms": 1500 },
      { "label": "conversational",       "delta_ms": 1200 },
      { "label": "emotional_weight",     "delta_ms": 800  },
      { "label": "conversation_pace",    "delta_ms": 600  },
      { "label": "busy_signal",          "delta_ms": 0    },
      { "label": "dependence_cooldown",  "delta_ms": 0    },
      { "label": "jitter",               "delta_ms": 150  },
      { "label": "floor_correction",     "delta_ms": 0    }
    ]
  },

  "auto_created_tasks": [
    {
      "title":     "Take blood pressure meds",
      "remind_at": "2026-05-19T20:00:00Z",
      "priority":  "high",
      "detector":  "medication_pattern"
    }
  ],

  "pii_scrub": [
    { "category": "email", "marker": "[REDACTED-EMAIL]" }
  ],

  "dependence_cooldown": null
}

When the EmotionalDependenceGate trips three or more times in 60 minutes for the same end-user, dependence_cooldown becomes{active: true, recent_count: N} and thedependence_cooldown timing component contributes+30000 ms.

All operations

Loading spec…