REST API Reference
All endpoints are prefixed with /api/v1. Use Bearer authentication for protected routes.
Base URL
https://wakelink-project.org/api/v1Authentication
Include the access token in the Authorization header:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
For WebSocket + device connections, use the api_token (format: wl_…).
Authentication
Authentication — Password
Authentication — 2FA (TOTP)
Authentication — Telegram
Agents (ESP32 Agents)
Releases
Admin (admin role required)
Error Codes
400Bad Request — validation error or malformed input
401Unauthorized — missing or invalid token
403Forbidden — insufficient permissions
404Not Found — resource does not exist
409Conflict — duplicate device ID or username
422Unprocessable Entity — schema validation failure
429Too Many Requests — rate limit exceeded
500Internal Server Error