/portalAPI/OnlineDevices/*

This 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 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 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 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
• Permissions Needed for User
  • View Computers
  • Install Computers