Endpoints Overview
Summary
| Endpoint | Purpose | Limits | Details |
|---|---|---|---|
POST /v1/events | Send contextual data | 1,000 chars | Docs |
POST /v1/events/generations | Trigger AI reaction | 300 chars; independent per-key windows: STANDARD ~25s, FAST 1s | Docs |
GET /v1/characters | List owned characters (id, name, description, active flag) | N/A | Docs |
PUT /v1/characters/{characterId}/active | Change the active character | Character must belong to the API key owner | Docs |
GET /v1/channels/status | Read runtime channel status | Requires API key; returns only channelName, isPrimary, isLive, isAiInChat | Docs |
POST /v1/streams/{channelName} | Request ai_licia to join chat | Requires channel authorization + active subscription/credits (mode=LIVE); mode=TEST runs demo test join flow | Docs |
DELETE /v1/streams/{channelName} | Request ai_licia to leave chat | Requires channel authorization | Docs |