Skip to main content
The computers endpoints return the computers in your workspace and each computer’s device compliance status. isMonitored tells you whether the Secfix agent reports a computer. Computers are read-only in the API, and so are their inventory assets. Their data comes from Secfix’s device integrations. Reads require Read access (all:read). See Scopes.

​
List computers

GET /v1/computers returns a cursor-paginated list of the computers in your workspace.

​
Get a computer

GET /v1/computers/{id} returns one computer by its id. An unknown id returns 404 not_found.

​
Filter by owner

Pass ownerId to list one employee’s computers. It takes one employee id: the id from the employees endpoints, which is also the ownerId on each computer. An id that matches no employee in your workspace returns an empty page.
A computer keeps its ownerId after the owner is terminated, so it still matches the ownerId filter. The Secfix app shows that computer as unassigned.

​
Compliance status

Each computer has a compliance object with the device’s security checks: Each computer also has id, name, serialNumber, operatingSystem, osVersion, ownerId, isMonitored, tags, and lastCheckedAt.
isMonitored is true when the Secfix agent reports the computer. A computer the agent doesn’t report is still listed, with isMonitored: false.