Endpoints Overview
Summary
| Endpoint | Purpose | Limits | Details |
|---|---|---|---|
POST /v1/events | Send contextual data | ~700 chars | Docs |
POST /v1/events/generations | Trigger AI reaction | ~300 chars; 1 request every ~25s per API key | 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 |