Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
API endpoints for listing and managing enrolled devices
GET /api/devices
[
{
"id": "dev_01hx...",
"name": "alice-macbook-pro",
"machine_id": "...",
"status": "active",
"enrolled_at": "2025-09-01T12:00:00Z",
"last_seen_at": "2025-10-14T17:55:00Z",
"metadata": {}
}
]
| Field | Type | Description |
|---|---|---|
id | string | Device ID |
name | string | Hostname reported at enrollment |
machine_id | string | Unique hardware identifier |
status | string | active or disabled |
enrolled_at | string | ISO 8601 enrollment timestamp |
last_seen_at | string | ISO 8601 last telemetry timestamp |
metadata | object | Arbitrary agent-reported metadata (JSONB) |
POST /api/devices/:device_id/disable
204 No Content
POST /api/devices/:device_id/enable
204 No Content
DELETE /api/devices/:device_id
204 No Content
| Code | Description |
|---|---|
403 | Caller does not have ORG_ADMIN role |
404 | Device not found or belongs to a different org |