Help CenterThis article will encompass all portalAPI calls that are related to /portalAPI/OnlineDevices/* endpoints
Be sure to input the instance your organization exists on for each call. This is indicated with the "INSTANCE" text in each endpoint. Linked here is a KB to find your instance:
Locating Your Organization's Instance | ThreatLocker Help Center
OnlineDevicesGetByParameters
https://portalapi.INSTANCE.threatlocker.com/portalapi/OnlineDevices/OnlineDevicesGetByParameters
- Method: GET
- Description: This API is utilized on the Not Installed tab of the Computers 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 as described below.
- Required Body/Parameters
- Valid APIKey/Authorization Token in header
- Optional Body/Parameters
- In header: "managedOrganizationId": <GUID> in format "00000000-0000-0000-0000-000000000000"
- pageSize and pageNumber: This field determines how many computers will be returned as if the response was on the Computers 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 Comptuers
- Install Computers