Get details of Current Device State

Retrieves the current settings and state snapshot for a single device.

Returns the DeviceSettings object representing the device's live configuration state, distinct from the broader device record returned by the main device detail endpoint.

About Get Device State

While GET /device/v0/devices/{id}/ returns a device's overall record (hardware, OS, blueprint assignment, and so on), this endpoint returns its current settings state specifically. It's a lighter-weight check when the only thing you need is the device's live configuration snapshot rather than its full profile.

Common Use Cases

Checking a device's current settings state without pulling its full device record

Confirming a configuration change has actually taken effect on the device

Best Practices

Use this endpoint instead of the full device detail endpoint when polling repeatedly for state changes, to reduce response size

Compare the returned state against the blueprint version a device was converged to, to confirm the Converge action applied as expected

Workflow

Obtain the device id

Call this endpoint to retrieve its current state

Compare against the expected blueprint or command outcome to confirm the change took effect