API Reference
Waypath’s REST + WebSocket API is the core product. The dashboard is one consumer; you can build your own integrations using these endpoints.
Base URL
https://api.waypath.appFor local development: http://localhost:4747
Authentication
All endpoints (except health check) require authentication via one of:
- JWT token:
Authorization: Bearer <token>(for dashboard users) - API key:
X-API-Key: dsk_...(for external consumers)
See Authentication for details.
Endpoints
| Section | Endpoints |
|---|---|
| Authentication | Register, login, session, API key management |
| Event Ingestion | Track events, identify customers, batch ingestion |
| Customers | List, get, timeline, dedupe |
| Intelligence Data | Full intelligence export, Cypher queries |
| Webhooks | Inbound platform webhooks |
| WebSocket | Real-time intelligence update stream |
| Playbooks | CRUD + run tracking for executable agent specs |
| Reporting | KPI summary + recent agent reasoning feed |
| Brand Context | Per-workspace business + voice profile |
Response format
All endpoints return JSON. Successful responses use standard HTTP status codes
(200, 201). Errors return { error: string } with appropriate 4xx/5xx codes.