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 cannot be deployed to multiple organizations in a single 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
- Edit Endpoint Detect Policies
- Edit Web Control Policies
- Edit All ThreatLocker Detect Policies
- Edit Patch Management Policies
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 an individual computer. New policy changes cannot be deployed to multiple computers in a single call to this API. The following fields are expected to be passed as query parameters, not in a request body. To deploy policy changes to a computer in 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
- Parameters
- computerId: This parameter expects the computerId of the computer having 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 having policy changes deployed.
- 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
- Edit Endpoint Detect Policies
- Edit Web Control Policies
- Edit All ThreatLocker Detect Policies
- Edit Patch Management Policies
Help Center