API Reference
Complete technical reference for all Devhelion API endpoints with request/response examples.
Analytics Endpoints
Knowledge Base Endpoints
Common Error Responses
401 Unauthorized
{
"error": "Authentication required"
}Missing or invalid API key. Check your Authorization header.
403 Forbidden
{
"error": "Insufficient permissions. Required scopes: agents:read"
}API key doesn't have required permissions for this endpoint.
404 Not Found
{
"error": "Resource not found"
}The requested resource doesn't exist or endpoint is not implemented yet.
500 Internal Server Error
{
"error": "Internal server error"
}Server error. If this persists, contact support.
Implementation Status
Working Endpoints (Verified):
- GET /api/data/insights - Returns 28+ insights
- POST /api/data/events - Returns 405 (Method Not Allowed)
- GET /api/knowledge-base/articles - Returns 13+ articles
Planned Endpoints (Coming Soon):
- POST /api/data/insights/{id}/read
- POST /api/data/insights/mark-all-read
- POST /api/data/events/batch
- GET /api/data/events/session
- GET /api/knowledge-base/articles/{id}
- POST /api/knowledge-base/bookmarks
- DELETE /api/knowledge-base/bookmarks/{id}
- GET /api/knowledge-base/history