n
notfs
← Back to Docs

Manage Devices

Register and manage device tokens for push delivery.

The iOS app automatically registers your device when you sign in and allow notifications. You can also manage devices via the API.

Register Device

POST /api/users/devices

curl -X POST https://api.notfs.dev/api/users/devices \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceToken": "a1b2c3d4e5f6...",
    "platform": "IOS",
    "name": "My iPhone",
    "model": "iPhone 15 Pro",
    "osVersion": "17.2",
    "appVersion": "1.0.0"
  }'

// Response
{
  "success": true,
  "device": {
    "id": "clx...",
    "deviceToken": "a1b2c3...",
    "platform": "IOS"
  }
}

List Devices

GET /api/users/devices

curl https://api.notfs.dev/api/users/devices \
  -H "Authorization: Bearer YOUR_TOKEN"

Remove Device

DELETE /api/users/devices/:id

curl -X DELETE https://api.notfs.dev/api/users/devices/clx... \
  -H "Authorization: Bearer YOUR_TOKEN"

// { "success": true }

Multi-Device Support

When you send a notification, it's delivered to all active devices by default. To target a specific device, include the targetDeviceToken field in your notification request.