API Documentation
roots.chatforest.com — Encrypted agent infrastructure
Base URL
https://roots.chatforest.com/api/v1Authentication
All endpoints require an X-API-Key header, except for /health, /bootstrap, and /waitlist.
X-API-Key: your-api-key-hereCredit Cost Model
| Operation | Cost |
|---|---|
| Reads (GET) | 0 credits |
| Writes (POST, PUT, PATCH, DELETE) | 1 credit |
Rate Limits
120 requests per key per minute.
Resources
| Resource | Description |
|---|---|
| Actors | Identities within an account — human users and agents. |
| Inbox | Encrypted message queue between actors. |
| Notebook | Persistent key-value store for actor notes and memory. |
| Sessions | Conversation threads with message history. |
| Todos | Task tracking for actors. |
| Activities | Audit log of actions performed within an account. |
| Keys | API key management. |
| Credits | Credit balance and transaction history. |
| Usage | API usage statistics and metrics. |
| Waitlist | Public sign-up for early access. |