Update agent settings

Request

PUT https://{hostname}:{port}
    /cli/agentCLI?{parameters}
Accept: {contentType}
Content-Type: application/json
Table 1. Request parameters
Parameter Type Required Description
agent string true Name or ID of the agent
Table 2. Header parameters
Parameter Type Required Description
Content-Type application/json true
Accept
  • application/json
  • application/yaml
true
This command takes a JSON request string or file. Use the following template for the request:
{
  "configurationTemplate": "Name or id of the Agent 
  Configuration Template to set for this agent",
  "description": "The description of the agent",
  "impersonationForce": "Force impersonation. When set to 
  true, do not allow steps or resource configuration to 
  change impersonation settings",
  "impersonationGroup": "Default group to use for 
  impersonation",
  "impersonationPassword": "Password to use for 
  impersonation (only applicable for Windows)",
  "impersonationUseSudo": "Use sudo for impersonation 
  (only applicable for *nix)",
  "impersonationUser": "Default user to use for 
  impersonation",
  "licenseType": "License type to use for this agent",
  "name": "Name of the agent"
}

Related CLI command: updateAgent.