Modifies the child process application group by adding or removing rules

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Updates the child process application group by adding new parent-process rules or removing existing ones.

Request URL

https://{server-hostname}:8383/dcapi/appctrl/childProcessGroup

Scope

AppControl.CREATECopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

content-typestringOptional

- Request Body

application/json
JSON object
Hide Sub-Attributes
addedRulesJSON arrayMandatory

Rules to add — prefetch IDs from Get Child Process Types

Show Sub-Attributes
JSON object
Show Sub-Attributes
appRuleTypelongMandatory

Rule type (1=Vendor, 2=Product, 3=Executable, 4=FileHash)

verifiedAppRepoIDsarrayOptional

Verified repository IDs (vendorID or productVendorID) — prefetch from Get Child Process Types (Omit this parameter if you are not adding any verified IDs.)

unVerifiedAppRepoIDsarrayOptional

Unverified repository IDs - prefetch from Get Child Process Types (Omit this parameter if you are not adding any unverified IDs.)

removedRulesJSON arrayMandatory

Rules to remove — prefetch appRuleID from Get Child Process Group

Show Sub-Attributes
JSON object
Show Sub-Attributes
appRuleTypelongMandatory

Rule type (1=Vendor, 2=Product, 3=Executable, 4=FileHash)

verifiedAppRepoIDsarrayOptional

Verified repository IDs (vendorID or productVendorID) — prefetch from Get Child Process Types (Omit this parameter if you are not adding any verified IDs.)

unVerifiedAppRepoIDsarrayOptional

Unverified repository IDs - prefetch from Get Child Process Types (Omit this parameter if you are not adding any unverified IDs.)

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
  --url https://appdomain/dcapi/appctrl/childProcessGroup \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'content-type: SOME_STRING_VALUE' \
  --data '{"removedRules":[{"appRuleType":1,"appRuleIDs":[620]}],"addedRules":[{"appRuleType":2,"verifiedAppRepoIDs":[750]}]}'
Show full

Sample Request Body

Update child process group — add product rules and remove existing vendor rules

Copied!
  {
    "removedRules": [
      {
        "appRuleType": 1,
        "appRuleIDs": [
          620
        ]
      }
    ],
    "addedRules": [
      {
        "appRuleType": 2,
        "verifiedAppRepoIDs": [
          750
        ]
      }
    ]
  }
                
Show full

Response Parameters

- HTTP code 200

Response Body - application/json
JSON object
Hide Sub-Attributes
applicationRulesJSON array

Array of newly added application rules with generated IDs

Show Sub-Attributes
JSON object
Show Sub-Attributes
appRuleTypeinteger

Rule type ID (1=Vendor, 2=Product, 3=Executable, 4=FileHash, 9=StoreApp)

appRuleNamestring

Display name of the application rule (e.g. 'Vendor Rule', 'Product Name Rule', 'StoreApp Rule')

trustedUpdaterinteger

Trusted updater flag (0=No, 1=Yes)

ruleDetailsJSON object

Detailed attributes of the rule — structure varies by appRuleType. See appctrl_vendorRuleDetails (type 1), appctrl_productRuleDetails (type 2), appctrl_storeAppRuleDetails (type 9).

Show Sub-Attributes
appRuleIDstring

Unique identifier for the application rule

isVerifiedinteger

Verification status (1=verified, 0=unverified)

productVendorIDstring

Product-vendor mapping ID

statusstring

Operation status (success)

- HTTP code 401

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodelong

Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)

errorMsgstring

Authentication failure reason

- HTTP code 500

Response Body - application/json
JSON object
Hide Sub-Attributes
errorCodestring

Internal error code: INTERNAL_ERROR when exception occurs updating child process group

errorMessagestring

Detailed message: Error Occurred while add or update Child process app group

Possible Response Codes

200HTTP code
401HTTP code
500HTTP code

Sample Response: HTTP 200

Child process group updated with new rules

Copied!
  {
    "applicationRules": [
      {
        "appRuleType": 2,
        "trustedUpdater": 0,
        "ruleDetails": {
          "appRuleID": "304",
          "isVerified": 1,
          "productVendorID": "358"
        },
        "appRuleName": ""
      }
    ],
    "status": "success"
  }
                
Show full

Sample Response: HTTP 401

Authentication credentials missing or invalid

Copied!
  {
    "errorMessage": "Authentication credentials are missing or invalid",
    "errorCode": "UNAUTHORIZED"
  }
                
Show full

Sample Response: HTTP 500

Internal error while updating child process group

Copied!
  {
    "errorMessage": "Error Occurred while add or update Child process app group",
    "errorCode": "INTERNAL_ERROR"
  }
                
Show full

Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.