Base URLs
| Environment | URL |
|---|---|
| Self-hosted | http://localhost:3100 |
| Production | https://api.yourserver.com |
API Groups
Proxy API
OpenAI-compatible LLM proxy endpoints
Profile API
Manage user profiles
Traits API
View and update user traits
Memories API
Access user memories
Endpoint Summary
Proxy Endpoints (OpenAI-compatible)
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/chat/completions | Chat completion with memory |
| GET | /v1/models | List available models |
Profile Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/profiles | List all profiles |
| POST | /api/profiles | Create or get profile by external ID |
| GET | /api/profiles/:id | Get profile details |
| DELETE | /api/profiles/:id | Delete profile |
| GET | /api/profiles/:id/export | Export profile data |
| POST | /api/profiles/:id/ingest | Ingest data and extract traits/memories |
Trait Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/profiles/:id/traits | List traits |
| PUT | /api/profiles/:id/traits/:key | Update trait |
| DELETE | /api/profiles/:id/traits/:key | Delete trait |
Memory Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/profiles/:id/memories | List memories |
| POST | /api/profiles/:id/memories | Create memory |
| DELETE | /api/profiles/:id/memories/:memoryId | Delete memory |
Utility Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /health | Health check |
| GET | /ready | Readiness check |