API Reference
API Overview
REST and WebSocket API introduction, authentication, and common patterns.
API Overview
Steadybase exposes a REST API and a WebSocket server for real-time updates. All endpoints require authentication.
Base URL
For local development:
Authentication
All API requests require a valid JWT token, obtained via the login endpoint:
Include the token in subsequent requests:
API Routers
| Router | Base Path | Purpose |
|---|---|---|
| Brain | /api/brain | Conversational AI chat interface |
| Workers | /api/workers | AI worker management |
| Deals | /api/deals | Deal pipeline and CRM |
| Memory | /api/memory | Hierarchical memory access |
| Drew | /api/drew | Drew Coordinator orchestration |
| WebSocket | /ws | Real-time event streaming |
Common Patterns
Response Format
All endpoints return JSON:
Error Responses
Rate Limits
| Endpoint Type | Limit | Window | Response on Exceed |
|---|---|---|---|
Auth (/auth/*) | 10 | 15 minutes | 429 Too Many Requests |
General (/api/*) | 300 | 15 minutes | 429 Too Many Requests |
Rate limit headers are included in responses:
Health Check
Returns server status, Temporal Cloud connection status, and uptime:
This endpoint does not require authentication.
Additional Endpoints
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/api/health | GET | No | Server health check |
/api/tasks/status | GET | Yes | Build task tracking |
/api/project/memory | GET | Yes | Project-level durable memory |
/api/config | GET | Yes | Client-side configuration (VAPI keys) |
/status | GET | No | Status dashboard HTML page |