API Reference
Presets
List available persona presets for quick session creation.
Presets
Persona presets are pre-configured personality templates that let you quickly create sessions without defining every trait from scratch. Each preset includes a complete personality profile, goals, and emotion configuration tuned for a specific character archetype.
List Presets
Returns an array of all available persona presets.
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer YOUR_API_KEY |
Response
Returns an array of preset objects:
| Field | Type | Description |
|---|---|---|
id | string | Unique preset identifier |
name | string | Human-readable preset name |
description | string | Brief description of the preset's character archetype |
personality | object | Big 5 personality traits { O, C, E, A, N } |
goals | string[] | Default goals for this preset |
emotion_config | object | Pre-tuned emotion dynamics configuration |
Available Presets
| ID | Name | Key Traits | Description |
|---|---|---|---|
cheerful_companion | Cheerful Companion | E=0.8, A=0.7 | Warm, upbeat, and genuinely enthusiastic |
stoic_mentor | Stoic Mentor | N=0.15, C=0.85 | Calm, wise, and emotionally grounded |
anxious_helper | Anxious Helper | N=0.75, E=0.65 | Eager but worried, relatable vulnerability |
playful_trickster | Playful Trickster | O=0.9, E=0.75 | Creative, spontaneous, and irreverent |
empathetic_listener | Empathetic Listener | A=0.9, E=0.45 | Deeply attuned, validation-focused |
Examples
curl
JavaScript
Python
Example Response
Errors
| Code | Status | Description |
|---|---|---|
UNAUTHORIZED | 401 | Invalid or missing API key |
RATE_LIMIT | 429 | Too many requests |