Help CenterThis article will encompass all portalAPI calls that are related to /portalAPI/OnlineDevices/* endpoints
If you are new to working with ThreatLocker PortalAPI endpoints and/or have questions regarding authentication and terminology used throughout this article, please look through the following guide:
OnlineDevicesGetByParameters
https://portalapi.INSTANCE.threatlocker.com/portalapi/OnlineDevices/OnlineDevicesGetByParameters
- Method: GET
- Description: This API is utilized on the Not Installed tab of the Devices page in the ThreatLocker Portal to display the endpoints in your environment that are detected without ThreatLocker installed. The Not Installed tab will only be displayed in the Portal if there are computers found without ThreatLocker and originates from the Logon Scripts that you can setup in your environment to routinely check and ensure ThreatLocker is installed onto all the machines you manage. This API will return a list of online computers without ThreatLocker installed. If looking to view the computers without ThreatLocker installed for a different organization than the currently logged-in/managed organization, utilize the managedOrganizationId header.
- Required Body/Parameters
- N/A
- Optional Body/Parameters
- pageSize and pageNumber: This field determines how many computers will be returned as if the response was on the Devices page. However, these fields do not follow the same conventions of the pageNumber and pageSize values as the Portal does (pageSize in the Portal is 25, 50, 100, 500). Any valid integer can be entered, and it will return the computers in the selected formatting. For instance, if there are 5 computers to be returned but “pageNumber” : 1 and “pageSize” : 2, 2 entries will be returned per page, and the first two computers will be shown.
- Expects: An Integer value
- pageSize and pageNumber: This field determines how many computers will be returned as if the response was on the Devices page. However, these fields do not follow the same conventions of the pageNumber and pageSize values as the Portal does (pageSize in the Portal is 25, 50, 100, 500). Any valid integer can be entered, and it will return the computers in the selected formatting. For instance, if there are 5 computers to be returned but “pageNumber” : 1 and “pageSize” : 2, 2 entries will be returned per page, and the first two computers will be shown.
- Permissions Needed for User
- View Computers
- Install Computers