Update a device - Phosra Developer Docs

import { PhosraClient } from "@phosra/sdk"; const phosra = new PhosraClient({ baseUrl: "https://phosra-api-sandbox-production.up.railway.app/api/v1", accessToken: process.env.PHOSRA_API_KEY, }); const result = await phosra.devices.update("d1e2f3a4-5b6c-4d7e-8f90-a1b2c3d4e5f6", { device_name: "Mia's iPhone", app_version: "1.5.0", os_version: "18.6" }); console.log(result);

{ "id": "5e0a9c37-1b64-4d82-96f3-2c8a7e0b4d19", "child_id": "ca02f5d1-fee8-4201-b5ca-fdc8be506e1e", "family_id": "fcdf4277-ba14-4732-8db5-0369b2c88d8b", "platform_id": "nextdns", "device_name": "Ada's iPhone", "device_model": "iPhone15,3", "os_version": "18.5", "app_version": "2.4.0", "apns_token": "8f7d3c1b2a90e64f5d8c7b6a1f0e9d3c2b1a0f9e8d7c6b5a4f3e2d1c0b9a8f7e6", "capabilities": [ "FamilyControls", "ManagedSettings", "DeviceActivity" ], "enforcement_summary": {}, "last_seen_at": "2026-07-05T22:04:18Z", "last_policy_version": 0, "status": "active", "created_at": "2026-06-18T14:32:07Z", "updated_at": "2026-06-30T09:15:44Z" }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

deviceID

string<uuid>

required

Body

application/json

device_name

string

User-assigned device name (e.g. "Ada's iPhone").

apns_token

string

Apple Push Notification service device token; null until the device registers for push.

app_version

string

Version of the Phosra app installed on the device.

os_version

string

Operating-system version reported by the device (e.g. 18.5).

Response

Device updated

string<uuid>

Unique identifier for this resource.

child_id

string<uuid>

Identifier of the child this resource belongs to.

family_id

string<uuid>

Identifier of the family this resource belongs to.

platform_id

string

Identifier of the associated platform.

device_name

string

User-assigned device name (e.g. "Ada's iPhone").

device_model

string

Hardware model identifier (e.g. iPhone15,3).

os_version

string

Operating-system version reported by the device (e.g. 18.5).

app_version

string

Version of the Phosra app installed on the device.

apns_token

string | null

Apple Push Notification service device token; null until the device registers for push.

capabilities

string[]

Apple frameworks the device supports (e.g. FamilyControls, ManagedSettings, DeviceActivity)

enforcement_summary

object

Per-category enforcement results from the device's last enforcement_status report

last_seen_at

string<date-time> | null

RFC 3339 timestamp.

last_policy_version

integer

Policy version the device last successfully applied.

status

enum<string>

Current lifecycle state of the resource.

Available options:

active,

inactive,

revoked

created_at

string<date-time>

RFC 3339 timestamp of when the resource was created.

updated_at

string<date-time>

RFC 3339 timestamp of the resource's most recent update.