This article will encompass all portalAPI calls that are related to /portalAPI/DeployPolicyQueue/* 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
DeployPolicies
https://portalapi.INSTANCE.threatlocker.com/portalapi/DeployPolicyQueue/DeployPolicies
- Method: POST
- Description: This API is used throughout the ThreatLocker Portal when clicking the Deploy Policies button in the top right of a Portal page. It is used to deploy new policy changes to all computers within the currently managed organization. New policy changes can not be deployed to multiple organizations at a time within one call to this API. To deploy policy changes to 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"
- Permissions Needed for User
- Edit Configuration Manager Policies
- Edit Application Control Policies
- Edit Storage Control Policies
- Edit Network Control Policies
- Edit Application Control Applications
- Manage Local Admin Settings
- Edit Organizations
- View Organizations
DeployPoliciesForComputer
https://portalapi.INSTANCE.threatlocker.com/portalapi/DeployPolicyQueue/DeployPoliciesForComputer
- Method: POST
- Description: This API is used on the Devices page in the ThreatLocker Portal when viewing an individual computer and clicking the Deploy Policies button in the top right corner of the computer sidebar. It is used to deploy new policy changes to the individual computer. New policy changes can not be deployed to multiple computers at a time within one call to this API. The following fields are expected to be passed in as query parameters outside a request body.
- Required Body/Parameters
- Valid APIKey/Authorization Token in header
- Parameters
- computerId: This parameter expects the computerId of the computer to have policy changes deployed.
- Expects: <GUID> in format "00000000-0000-0000-0000-000000000000"
- computerName: This parameter expects the hostname/display name of the computer in the ThreatLocker Portal having policy changes deployed. This ensures the policy deployment is accurately logged with the correct computer name in the System Audit.
- Expects: hostname/display name text
- computerId: This parameter expects the computerId of the computer to have policy changes deployed.
- Optional Body/Parameters
- N/A
- Permissions Needed for User
- Edit Configuration Manager Policies
- Edit Application Control Policies
- Edit Storage Control Policies
- Edit Network Control Policies
- Edit Application Control Applications
- Manage Local Admin Settings
- Edit Organizations
- View Organizations