Docs / API Reference
API Reference
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/health | none | Liveness probe |
| GET | /api/topology | approved user | Proxies coordinator topology |
| GET | /api/devices | approved user | List visible devices |
| POST | /api/devices | admin | Create a device record |
| GET | /api/devices/:id/models | viewer | List models on the device |
| POST | /api/devices/:id/exec-token | operator | Mint a 5-minute terminal JWT |
| POST | /api/inference | viewer | Device-scoped inference |
| POST | /api/admin/users/:id/approve | admin | Approve a profile |
| POST | /api/admin/users/:id/reject | admin | Reject a profile (optional reason) |
| POST | /api/admin/tokens | admin | Issue a pairing token |
Planned
The following endpoints are reserved for upcoming releases and are not yet documented for integration.
- GET /api/devices/:id/audit
- POST /api/admin/devices
- POST /api/admin/device-grants
- DELETE /api/admin/device-grants/:id
- WS /api/ws/terminal/:deviceId