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 |
| Graph | Full graph dump, Cypher queries |
| Webhooks | Inbound platform webhooks |
| WebSocket | Real-time graph mutation stream |
Response format
All endpoints return JSON. Successful responses use standard HTTP status codes
(200, 201). Errors return { error: string } with appropriate 4xx/5xx codes.