Devices

The desktop app calls /auth/devices/register the first time it signs in on a machine, then re-calls it on subsequent launches to refresh lastSeenAt. The free tier caps you at 1 bound device; paid tiers raise the limit.

POST /auth/devices/register

Authenticated. Idempotent: re-registering an existing (user, deviceId) pair updates the row instead of inserting.

Body
{
  "deviceId": string (8-64 chars, stable per machine),
  "name":     string (1-128),
  "platform": "darwin" | "win32" | "linux" | "web"
}

200 OK   (refreshed existing row)
201 Created   (new device, under the cap)
{ "device": { id, deviceId, name, platform, lastSeenAt, createdAt } }

Errors
  400 INVALID_REQUEST
  409 DEVICE_LIMIT_REACHED

GET /auth/devices

List bound devices on your account.

200 OK
{
  "devices": [
    { id, deviceId, name, platform, lastSeenAt, createdAt, updatedAt },
    ...
  ],
  "cap": number
}

DELETE /auth/devices/:id

Unlink a device you own.

200 OK
{ "success": true }

Errors
  400 INVALID_REQUEST
  404 DEVICE_NOT_FOUND