Agent Client Collector API

</td></tr><tr><td>
agent\_id
</td><td id="accAgents-parm-agent-obj-id-entry">
ID of the agent as submitted.Data type: String
</td></tr><tr><td>
data\_collection
</td><td id="accAgents-parm-agent-obj-dataCollect-entry">
Data collection indicates whether scheduled checks are to be run. These checks are a part of the policies scheduled for this agent to run.Possible values:
-   0: On – Checks run as scheduled.-   1: Off \(manual\) – Checks have been disabled manually.-   2: Off \(auto\) – Checks have been disabled automatically due to high CPU consumption by the
 Data type: Number
</td></tr><tr><td>
ip\_address
</td><td id="accAgents-parm-agent-obj-ip-entry">
Agent IP address.Data type: String
</td></tr><tr><td>
is\_duplicate
</td><td id="accAgents-parm-agent-obj-dup-entry">
Flag that indicates whether this agent is a duplicate of another. There should be only a single agent on a given host.
 Possible values:
-   true: The agent has the same host as an Alive/Up agent with a different agent ID. Turn off or uninstall the duplicate-   false: This agent has no duplicates in the Alive/Up state.
 Data type: Boolean
</td></tr><tr><td>
is\_restart\_enabled
</td><td id="accAgents-parm-agent-obj-restart-entry">
Flag that indicates whether restart is enabled. Agent restart is not configurable. It depends on the OS and the version of the OS the agent is running on.
 Possible values:
-   true: Restart is enabled for this agent.-   false: Restart is disabled for this agent.
 Data type: Boolean
</td></tr><tr><td>
name
</td><td id="accAgents-parm-agent-obj-name-entry">
Name of the agent.Data type: String
</td></tr><tr><td>
number\_of\_running\_checks
</td><td id="accAgents-parm-agent-obj-numChecks-entry">
The number of checks the agent is scheduled to run. These checks are a part of the policies scheduled for this agent to run.Data type: Number
</td></tr><tr><td>
status
</td><td id="accAgents-parm-agent-obj-status-entry">
Status of the agent.Possible values:
-   0: Alive/Up – The agent is active.-   1: Warning – The agent has not received a keep-alive message in the past few minutes.-   2: Down – The agent has not received a keep-alive message in a long time.-   3: Restarting – The agent is restarting.
 Data type: Number
</td></tr><tr><td>
up\_since
</td><td id="accAgents-parm-agent-obj-up-entry">
UTC time since the agent's status became alive/up. The value is in [GlideDateTime](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/server-api-reference/c_GlideDateTimeScoped.md) format.Data type: String
</td></tr><tr><td>
version
</td><td id="accAgents-parm-agent-obj-version-entry">
Version of Agent Client Collector the agent is running.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to get agent details.

Output:

## Agent Client Collector - GET /agents/\{agent\_id\}/data/off
Disables data collection for a specified agent in the up/alive state.
To determine if an agent's data collection is on or off, run the GET /agents/\{agent\_id\} endpoint.
### URL format
`/api/sn_agent/agents/{agent_id}/data/off`
### Supported request parameters
<table id="table_oyt_cd3_dpb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
agent\_id
</td><td>
Unique ID of an agent listed in the Agent ID column of the Agent Client Collectors \[sn\_agent\_cmdb\_ci\_agent\] table. For a list of agent IDs and other details, run the GET /agents/list endpoint.
 Data type: String
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|Agent not found or isn't in the up/alive state.|
### Response body parameters \(JSON\)
<table id="table_owl_zyc_z4b"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
message
</td><td>
Message containing operation success or failure results.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to turn off agent data collection.

Output:

## Agent Client Collector - GET /agents/\{agent\_id\}/data/on
Enables data collection for a specified agent in the up/alive state.
To determine if an agent's data collection is on or off, run the GET /agents/\{agent\_id\} endpoint.
### URL format
`/api/sn_agent/agents/{agent_id}/data/on`
### Supported request parameters
<table id="table_oyt_cd3_dpb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
agent\_id
</td><td>
Unique ID of an agent listed in the Agent ID column of the Agent Client Collectors \[sn\_agent\_cmdb\_ci\_agent\] table. For a list of agent IDs and other details, run the GET /agents/list endpoint.
 Data type: String
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|Agent not found or isn't in the up/alive state.|
### Response body parameters \(JSON\)
<table id="table_owl_zyc_z4b"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
message
</td><td>
Message containing operation success or failure results.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to turn on agent data collection.

Output:

## Agent Client Collector - GET /agents/\{agent\_id\}/discovery
Runs a discovery check to locate CIs related to an agent. The specified agent must be in alive/up status.
### URL format
`/api/sn_agent/agents/{agent_id}/discovery`
### Supported request parameters
<table id="table_oyt_cd3_dpb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
agent\_id
</td><td>
Unique ID of an agent listed in the Agent ID column of the Agent Client Collectors \[sn\_agent\_cmdb\_ci\_agent\] table. For a list of agent IDs and other details, run the GET /agents/list endpoint.
 Data type: String
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|Agent not found or isn't in the up/alive state.|
### Response body parameters \(JSON\)
<table id="table_owl_zyc_z4b"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
message
</td><td>
Message containing operation success or failure results.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to run discovery on an agent with alive/up status.

Output:

## Agent Client Collector - GET /agents/check\_defs/\{check\_def\_id\}
Gets a specified check definition with details.
### URL format
`/api/sn_agent/agents/check_defs/{check_def_id}`
### Supported request parameters
<table class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
check\_def\_id
</td><td>
Sys\_id of the check definition listed in the Check Definitions \[sn\_agent\_check\_def\] table. Data type: String
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
<table class="rest_api_request_body"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
X-Include-Check-Params
</td><td>
Flag that indicates whether existing check parameter details are returned. Information for each standard and secure check parameter is included in a JSON object. Valid values:
-   true: Return check parameter details.-   false: Do not return check parameter details.
 Data type: Boolean
 Default: False
</td></tr></tbody></table>### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||404|Check definition was not found with the sys\_id provided.|
### Response body parameters \(JSON\)
<table><thead><tr><th>
Properties
</th><th>
Description
</th></tr></thead><tbody><tr><td>
check
</td><td>
Details of the specified check definition.```{ "background": Boolean, "check_group": "String", "check_type": "String", "command": "String", "error": "String", "name": "String", "params": [Array], "plugins": [Array], "proxy_valid": Boolean, "secure_params": [Array], "sys_id": "String", "timeout": Number}

 Data type: Array
</td></tr><tr><td>
params.active
</td><td>
Flag that indicates whether the check parameter is active. Valid values:
-   true: The check parameter is active.-   false: The check parameter is inactive.
 Data type: Boolean
</td></tr><tr><td>
params.default\_value
</td><td>
Specifies the default value for this check parameter. Data type: String
</td></tr><tr><td>
params.mandatory
</td><td>
Flag that indicates whether the check parameter is required. Valid values:
-   true: The check parameter is required.-   false: The check parameter is optional.
 Data type: Boolean
</td></tr><tr><td>
params.name
</td><td>
Name of the check parameter. Data type: String
</td></tr><tr><td>
params.sys\_id
</td><td>
Sys\_id of the check parameter listed in the Check Secure Parameter Definitions \[sn\_agent\_check\_param\_def\] table. Data type: String
</td></tr><tr><td>
plugins
</td><td>
List of [Agent Client Collector plugins](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/acc-assets.md) associated with this check. Data type: Array
</td></tr><tr><td>
proxy\_valid
</td><td>
Flag that indicates whether the check definition policy is set to work as a proxy. Valid values:
-   true: This check definition policy is set to work as a proxy.-   false: This check definition policy is not set to work as a proxy.
 Data type: Boolean
</td></tr><tr><td>
secure\_params
</td><td>
List of assigned to this check. These results are only included if the **withParams** parameter is set to true.```"secure_params": [  {    "active": Boolean,    "name": "String",    "order": Number,    "sys_id": "String"   }]

 Data type: Array
</td></tr><tr><td>
background
</td><td id="accCkDf-background-desc">
Flag that indicates whether this check definition is a background check. A background check is a check which the agent starts execution of and doesn't wait for it to finish running. Valid values:
-   true: This check definition is a background check.-   false: This check definition is not a background check.
 Data type: Boolean
</td></tr><tr><td>
check\_group
</td><td id="accCkDf-chkGrp-desc">
Group specified for this check definition. Data type: String
</td></tr><tr><td>
check\_type
</td><td id="accCkDf-chkTyp-desc">
Type of check. Possible values:
-   Events – Check results are transformed into an Event Management event.-   Metrics – Values from the check result are transformed to metrics.
 Data type: String
</td></tr><tr><td>
command
</td><td id="accCkDf-command-desc">
Command that the Agent Client Collector executes. Data type: String
</td></tr><tr><td>
name
</td><td id="accCkDf-name-desc">
Name of the check. Data type: String
</td></tr><tr><td>
params
</td><td id="accCkDf-p-desc">
List of parameter definitions associated with the check definition. These results are only included if the **withParams** parameter is set to true.```"params": [  {    "active": Boolean,    "default_value": "String",    "mandatory": Boolean,    "name": "String",    "sys_id": "String"   }]

 Data type: Array
</td></tr><tr><td>
secure\_params.active
</td><td id="accCkDf-sp-active-desc">
Flag that indicates whether the secure parameter is active. Valid values:
-   true: The secure parameter is active.-   false: The secure parameter is inactive.
 Data type: Boolean
</td></tr><tr><td>
secure\_params.name
</td><td id="accCkDf-sp-name-desc">
Name of the secure parameter. Data type: String
</td></tr><tr><td>
secure\_params.order
</td><td id="accCkDf-sp-order-desc">
Order in which the parameter is sent to the check command/script. Data type: Number
</td></tr><tr><td>
secure\_params.sys\_id
</td><td id="accCkDf-sp-id-desc">
Sys\_id of the secure parameter listed in the Check Secure Parameter Definitions \[sn\_agent\_check\_secure\_param\_def\] table. Data type: String
</td></tr><tr><td>
sys\_id
</td><td id="accCkDf-id-desc">
Sys\_id of the check definition listed in the Check Definitions \[sn\_agent\_check\_def\] table. Data type: String
</td></tr><tr><td>
timeout
</td><td id="accCkDf-timeout-desc">
Timeout in seconds. Data type: Number
</td></tr></tbody></table>### cURL request
The following example shows how to retrieve a list of two check definitions with parameter values.

Output:

## Agent Client Collector - GET /agents/exec/background/stop/\{request\_id\}
Stops a background check.
To start a background check, use the POST /agents/check\_defs/\{check\_def\_id\}/run API.
### URL format
`/api/sn_agent/agents/exec/background/stop/{request_id}`
### Supported request parameters
|Name|Description||----|-----------||request\_id|The ID of a background check request generated by running the POST /agents/check\_defs/\{check\_def\_id\}/run API.|
|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||404|The request with the ID provided is not found.|
### Response body parameters \(JSON\)
|Name|Description||----|-----------||None| |
### cURL request
The following example shows how to stop a background check.

## Agent Client Collector - GET /agents/exec/run/\{request\_id\}
Gets status of the request with the given ID.
### URL format
`/api/sn_agent/agents/exec/run/{request_id}`
### Supported request parameters
|Name|Description||----|-----------||request\_id|The ID of a background check request generated by running the POST /agents/check\_defs/\{check\_def\_id\}/run API.|
|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||202|Message with provided ID indicating that the request is in progress.||400|Error in the arguments provided in the request body.||404|The request with the ID provided is not found.||408|Execution timeout for the request with the ID provided.||500|Error checking the status or the request with the ID provided.|
### Response body parameters \(JSON\)
<table><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
status
</td><td>
Request status.Possible values:
-   done – Check is successful.-   failure – Check has failed. See error message for details.-   mid\_flow – Request output is being handled by the MID server.-   processing – Check is in progress.-   timeout – Check processing exceeded time limit set in the runCheckForCis\(\) method.
 Data type: String
</td></tr><tr><td>
err\_msg
</td><td>
Error message if any.Possible values:
-   No agents found for relevant CIs.-   No background check request with given ID.-   No request with given ID.-   No test result with given ID.-   Request timeout.
 Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to get the status of a request.

## Agent Client Collector - GET /agents/exec/test/\{test\_result\_id\}
Gets the test check status of the given test result.
### URL format
`/api/sn_agent/agents/exec/test/{test_result_id}`
### Supported request parameters
|Name|Description||----|-----------||test\_result\_id|A test result ID generated by creating a test check request.|
|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||202|Message with provided ID indicating that the request is in progress.||404|The request with the ID provided is not found.||408|Execution timeout for the request with the ID provided.||500|Error checking the status of the request with the ID provided.|
### Response body parameters \(JSON\)
<table><thead><tr><th>
Properties
</th><th>
Description
</th></tr></thead><tbody><tr><td>
status
</td><td>
Status of the test results.Possible values:
-   0: Pending-   1: In progress-   2: Complete-   3: No test result with given ID
 Data type: String
</td></tr><tr><td>
output
</td><td>
Output describing the status.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how get result status of a completed test check request.

## Agent Client Collector - GET /agents/list
Gets a list of agents with related information.
### URL format
`/api/sn_agent/agents/list`
### Supported request parameters
|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
<table class="rest_api_request_headers"><thead><tr><th>
Header
</th><th>
Description
</th></tr></thead><tbody><tr><td>
Accept
</td><td id="accept-JSON-only-entry-RESTAPI">
Data format of the response body. Only supports **application/json**.
</td></tr><tr><td>
X-Enc-Query
</td><td>
Encoded query on the Agent Client Collectors \[sn\_agent\_cmdb\_ci\_agent\] table in standard Glide format. See [Encoded query strings](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-user-interface/c_EncodedQueryStrings.md).
</td></tr><tr><td>
X-Limit
</td><td>
Restricts results to a maximum number of agents. Use null or undefined for both if they are not required.Default/Max: 20,000Data type: Number
</td></tr></tbody></table>|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_user role.|
### Response body parameters \(JSON\)
<table><thead><tr><th>
Property
</th><th>
Description
</th></tr></thead><tbody><tr><td>
&lt;Array&gt;
</td><td>
Array of JSON objects containing extended agent information.```[ {   "agent_id": "String",   "data_collection": Number,   "ip_address": "String",   "is_duplicate": Boolean,   "is_restart_enabled": Boolean,   "name": "String",   "number_of_running_checks": Number,   "status": Number,   "up_since": "String",   "version": "String" }]

 Data type: Array
</td></tr><tr><td>
policies.active
</td><td>
Flag that indicates whether the policy is active.Valid values:
-   true: Policy is active.-   false: Policy isn't active.
Data type: Boolean
</td></tr><tr><td>
policies.agent\_ids
</td><td>
Unique ID of an agent. These results only display if the **X-Include-Checks-And-Agents** header parameter is set to true.For extended information of an agent, run the ID in the [GET /agents/\{agent\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md) endpoint.
Data type: String
Table: In the Agent ID column of the Agent Client Collectors \[sn\_agent\_cmdb\_ci\_agent\] table.
</td></tr><tr><td>
policies.checks
</td><td>
List of objects defining checks listed in the Check Instances \[sn\_agent\_check\] table. These results only display if the **X-Include-Checks-And-Agents** or **X-Include-Check-Params** header parameter is set to true.Data type: Array of Objects

Table:
</td></tr><tr><td>
policies.checks.active
</td><td>
Flag that indicates whether the policy check is active.Valid values:
-   true: Policy check is active.-   false: Policy check is inactive.
Data type: Boolean
</td></tr><tr><td>
policies.checks.auto\_generate
</td><td>
Flag that indicates whether to automatically generate the command with the **command\_prefix** value.Valid values:
-   true: Automatically populate the **command** property with active parameter values.-   false: Command isn't automatically generated.
Data type: Boolean
</td></tr><tr><td>
policies.checks.check\_type
</td><td>
Check type specifying the monitoring option.Possible values:
-   Discovery: Check that locates CIs related to the agent.-   Events: The check's result is transformed into an Event Management event.-   Metrics: The values from the check result are transformed to metrics.
Data type: String
</td></tr><tr><td>
policies.checks.command
</td><td>
Command that the Agent Client Collector executes. Parameter taken from a template or monitored CI.**Note:** If **auto\_generate** is true, this property is automatically populated with the prefix and flags of the active parameters listed in the **parameters** object.
Data type: String
</td></tr><tr><td>
policies.checks.command\_prefix
</td><td>
If the **auto\_generate** property is true, this command is used for automatic generation. The prefix consists of any portion of the command which is static \(does not change\), such as the script name.Data type: String
</td></tr><tr><td>
policies.checks.event\_status\_change\_threshold
</td><td>
Number of consecutive times that a check's response status must happen before a new event is sent. Returns null if not set.For example, if this value is 3, a check whose response status changes from OK to Error generates a new event with an Error status after the third consecutive occurrence of the status change.
Data type: Number
</td></tr><tr><td>
policies.checks.event\_status\_repair\_threshold
</td><td>
Number of consecutive times that a check's response status must improve to close the previous event. Returns null if not set. For example, if this value is 3, a check whose response status changes from Error to OK closes the previous event and generates a new event with an OK status after the third consecutive occurrence of the status change.
Data type: Number
</td></tr><tr><td>
policies.checks.interval
</td><td>
Amount of time in seconds to wait between check executions. For example, a value of 60 means that the check runs every 60 seconds.Data type: Number
</td></tr><tr><td>
policies.checks.name
</td><td>
Name of the check.Data type: String
</td></tr><tr><td>
policies.checks.sys\_id
</td><td>
Sys\_id of the check.Data type: String
Table: Check Instances \[sn\_agent\_check\]
</td></tr><tr><td>
policies.checks.timeout
</td><td>
Amount of time, in seconds, after which the check execution stops when no output is returned. For example, a value of 60 means that when the check execution doesn't return a value for 60 seconds, the execution stops.Data type: String
</td></tr><tr><td>
policies.cred\_alias
</td><td>
Credential name.Data type: String
Table: Credentials \[discovery\_credentials\]
</td></tr><tr><td>
policies.credential\_alias
</td><td>
Sys\_id of the credential alias.Data type: String
Table: Connection &amp; Credential Aliases \[sys\_alias\]
</td></tr><tr><td>
policies.filter
</td><td>
Filter restricting the policy's checks to monitor only the specified criteria. Data type: String
</td></tr><tr><td>
policies.interval
</td><td>
Amount of time in seconds to wait between policy checks. For example, a value of 60 means that the check runs every 60 seconds.**Note:** The value of the **checks.interval** property overrides the value configured in this field.
Data type: Number
</td></tr><tr><td>
policies.monitored\_ci\_group
</td><td>
Name of the [CMDB groups](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/cmdb-groups.md) associated with the policy.This field is only applied if the value of the **monitored\_ci\_type\_group** property is true.
Data type: String
Table: CMDB Groups \[cmdb\_group\]
</td></tr><tr><td>
policies.monitored\_ci\_script
</td><td>
Script for monitoring CIs.This field is only applied if the value of the **policies.monitored\_ci\_type\_script** property is true.
Data type: String
</td></tr><tr><td>
policies.monitored\_ci\_type\_filter
</td><td>
Flag that indicates whether filtering by CI type is enabled. The CI type is listed in the **table** property.Valid values:
-   true: Filtering by checks group is enabled.-   false: Filtering by checks group is disabled.
Data type: Boolean
</td></tr><tr><td>
policies.monitored\_ci\_type\_group
</td><td>
Flag that indicates whether monitoring by CMDB group type is enabled.Valid values:
-   true: CMDB group type is enabled.-   false: CMDB group type is disabled.
Data type: Boolean
</td></tr><tr><td>
policies.monitored\_ci\_type\_script
</td><td>
Flag that indicates whether the script for monitoring CIs is enabled.Valid values:
-   true: Script for monitoring CIs is enabled.-   false: Script for monitoring CIs is disabled.
Data type: Boolean
</td></tr><tr><td>
policies.name
</td><td>
Name of the policy.Data type: String
</td></tr><tr><td>
policies.publish\_status
</td><td>
Indicates whether the policy is published. Possible values:
-   Draft: Policy has not been published and is editable using the update endpoints.-   Published: Policy is published. The draft \(sandbox copy\) and published copy are identical.-   Published\*: Policy is published, but the draft copy \(sandbox view\) has changes not found in the published copy.
Data type: String
</td></tr><tr><td>
policies.sys\_id
</td><td>
Sys\_id of the policy.Data type: String
Table: Policies \[sn\_agent\_policy\]
</td></tr><tr><td>
policies.sys\_updated\_on
</td><td>
Date and time that the policy was last updated.Data type: String
</td></tr><tr><td>
policies.table
</td><td>
Monitored CI-type field on the policy. This field is only applied if **monitored\_ci\_type\_filter** is true.Data type: String
</td></tr><tr><td>
policies.params
</td><td>
List of objects containing information of check parameters. These results only display if the **X-Include-Check-Params** header parameter is set to true.Data type: Array of Objects

Table: Check Parameters \[sn\_agent\_check\_param\]
</td></tr><tr><td>
policies.params.active
</td><td>
Flag that indicates whether the check parameter is active.Valid values:
-   true: Check parameter is active.-   false: Check parameter is inactive.
Data type: Boolean
</td></tr><tr><td>
policies.params.flag
</td><td>
Parameter flag to use during check invocation.Data type: String
</td></tr><tr><td>
policies.params.mandatory
</td><td>
Flag that indicates whether this check is mandatory.Valid values:
-   true: This check is mandatory.-   false: This check is optional.
Data type: Boolean
</td></tr><tr><td>
policies.params.name
</td><td>
Name of the parameter.Data type: String
</td></tr><tr><td>
policies.params.sys\_id
</td><td>
Sys\_id of the parameter.Data type: String
Table: Check Parameters \[sn\_agent\_check\_param\]
</td></tr><tr><td>
policies.params.value
</td><td>
Value of the parameter.Data type: String
</td></tr><tr><td>
policies.params.value\_required
</td><td>
Flag that indicates whether the information provided by the value property is required.Valid values:
-   true: The value property is required.-   false: The value property is null or not required.
Data type: Boolean
</td></tr><tr><td>
policies.secure\_params
</td><td>
List of objects containing information of check secure parameters. For more information, see [Create a secure parameter for a check](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/acc-create-secure-params.md). These results only display if the **X-Include-Check-Params** header parameter is set to true.Data type: Array of Objects

Table: Check Secure Parameters \[sn\_agent\_check\_secure\_param\]
</td></tr><tr><td>
policies.secure\_params.active
</td><td>
Flag that indicates whether the check secure parameter is active.Valid values:
-   true: The check secure parameter is active.-   false: The check secure parameter is inactive.
Data type: Boolean
</td></tr><tr><td>
policies.secure\_params.name
</td><td>
Name of the secure parameter.Data type: String
</td></tr><tr><td>
policies.secure\_params.order
</td><td>
Order in which the parameter is sent to the check command/script.Data type: Number
</td></tr><tr><td>
policies.secure\_params.sys\_id
</td><td>
Sys\_id of the record.Data type: String
Table: Check Secure Parameter \[sn\_agent\_check\_secure\_param\]
</td></tr></tbody></table>### cURL request
The following example shows how to restrict results by query and number. The query returns all active policies and the ID of the associated agent.

Output:

## Agent Client Collector - GET /agents/policy/activate/\{policy\_id\}
Activates a published policy.
For a list of published policies, use [GET /agents/policies/list](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md). This endpoint only supports sys\_ids in which the value of the policy's **publish\_status** property is `Published` or `Published*`.
### URL format
`/api/sn_agent/agents/policy/activate/{policy_id}`
### Supported request parameters
<table id="table_n3g_1fs_2pb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
policy\_id
</td><td id="agntCC-entry-parm-policyID-pub">
Sys\_id of the published policy.Data type: String
Table: Policies \[sn\_agent\_policy\]
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|No record found with the provided sys\_id.||500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|
### Response body parameters \(JSON\)
<table id="table_h5l_bgs_2pb"><thead><tr><th>
Header
</th><th>
Description
</th></tr></thead><tbody><tr><td>
message
</td><td>
Message containing operation success or failure results.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to activate a policy.

Output:

## Agent Client Collector - GET /agents/policy/deactivate/\{policy\_id\}
Deactivates a published policy.
For a list of published policies, use [GET /agents/policies/list](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md). This endpoint only supports sys\_ids in which the value of the policy's **publish\_status** property is `Published` or `Published*`.
### URL format
`/api/sn_agent/agents/policy/activate/{policy_id}`
### Supported request parameters
<table id="table_f4v_qfs_2pb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
policy\_id
</td><td id="agntCC-entry-parm-policyID-pub">
Sys\_id of the published policy.Data type: String
Table: Policies \[sn\_agent\_policy\]
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|No record found with the provided sys\_id.||500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|
### Response body parameters \(JSON\)
<table id="table_h5l_bgs_2pb"><thead><tr><th>
Header
</th><th>
Description
</th></tr></thead><tbody><tr><td>
message
</td><td>
Message containing operation success or failure results.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to deactivate a policy.

Output:

## Agent Client Collector - GET /agents/policy/publish/\{policy\_id\}
Publishes a draft policy.
Use any of the following endpoints to modify a draft or sandbox copy prior to publishing:
-   [POST /agents/update/policy/\{policy\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)-   [POST /agents/update/check/\{check\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)-   [POST /agents/update/check\_param/\{param\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)-   [POST /agents/update/check\_secure\_param/\{param\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)
### URL format
`/api/sn_agent/agents/policy/publish/{policy_id}`
### Supported request parameters
<table id="table_n3g_1fs_2pb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
policy\_id
</td><td>
Sys\_id of a policy in the Policies \[sn\_agent\_policy\] table that is in Draft state or a sandbox copy.-   For a list of policies and details including publish state, use [GET /agents/policies/list](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md).-   To retrieve sandbox copy of a policy, use [GET /agents/policy/sandbox\_from\_published/\{policy\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md).
 Data type: String
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|No record found with the provided sys\_id.||500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|
### Response body parameters \(JSON\)
<table id="table_h5l_bgs_2pb"><thead><tr><th>
Header
</th><th>
Description
</th></tr></thead><tbody><tr><td>
message
</td><td>
Message containing operation success or failure results.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to publish a policy.

Output:

## Agent Client Collector - GET /agents/policy/sandbox\_from\_published/\{policy\_id\}
Gets the sandbox copy of a published policy and provides policy details.
Use the sandbox copy to make updates to a policy and publish. You can use the sys\_ids in the response body to work with the following endpoints:
-   [POST /agents/update/policy/\{policy\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)-   [POST /agents/update/check/\{check\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)-   [POST /agents/update/check\_param/\{param\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)-   [POST /agents/update/check\_secure\_param/\{param\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md)
For a list of published policies, use [GET /agents/policies/list](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md). This endpoint only supports sys\_ids in which the value of the policy's **publish\_status** property is `Published` or `Published*`.
### URL format
`/api/sn_agent/agents/policy/sandbox_from_published/{policy_id}`
### Supported request parameters
<table id="table_n3g_1fs_2pb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
policy\_id
</td><td id="agntCC-entry-parm-policyID-pub">
Sys\_id of the published policy.Data type: String
Table: Policies \[sn\_agent\_policy\]
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|No record found with the provided sys\_id.||500|Internal server error. An unexpected error occurred while processing the request. The response contains additional information about the error.|
### Response body parameters \(JSON\)
<table><thead><tr><th>
Property
</th><th>
Description
</th></tr></thead><tbody><tr><td>
&lt;Object&gt;
</td><td>
Extended details of the sandbox copy associated with the policy. For information on policies, see [default checks and policies](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/agent-policies-checks.md).```{  "active": Boolean"  "agent_ids": "String",  "checks": [Array],  "cred_alias": "String",  "credential_alias": "String",  "filter": "String",  "interval": "Number",  "monitored_ci_group": "String",  "monitored_ci_script": "String",  "monitored_ci_type_filter": Boolean,  "monitored_ci_type_group": Boolean,  "monitored_ci_type_script": "String",  "name": "String",  "params": [Array],  "publish_status": "String",  "secure_params": [Array],  "sys_id": "String",  "sys_updated_on": "String",  "table": "String"}

 Data type: Array
</td></tr><tr><td>
checks.active
</td><td>
Flag that indicates whether the policy check is active.Valid values:
-   true: Policy check is active.-   false: Policy check is inactive.
Data type: Boolean
</td></tr><tr><td>
checks.auto\_generate
</td><td>
Flag that indicates whether to automatically generate the command with the **command\_prefix** value.Valid values:
-   true: Automatically populate the **command** property with active parameter values.-   false: Command isn't automatically generated.
Data type: Boolean
</td></tr><tr><td>
checks.check\_type
</td><td>
Check type specifying the monitoring option.Possible values:
-   Discovery: Check that locates CIs related to the agent.-   Events: The check's result is transformed into an Event Management event.-   Metrics: The values from the check result are transformed to metrics.
Data type: String
</td></tr><tr><td>
checks.command
</td><td>
Command that the Agent Client Collector executes. Parameter taken from a template or monitored CI.**Note:** If **auto\_generate** is true, this property is automatically populated with the prefix and flags of the active parameters listed in the **parameters** object.
Data type: String
</td></tr><tr><td>
checks.command\_prefix
</td><td>
If the **auto\_generate** property is true, this command is used for automatic generation. The prefix consists of any portion of the command which is static \(does not change\), such as the script name.Data type: String
</td></tr><tr><td>
checks.event\_status\_change\_threshold
</td><td>
Number of consecutive times that a check's response status must happen before a new event is sent. Returns null if not set.For example, if this value is 3, a check whose response status changes from OK to Error generates a new event with an Error status after the third consecutive occurrence of the status change.
Data type: Number
</td></tr><tr><td>
checks.event\_status\_repair\_threshold
</td><td>
Number of consecutive times that a check's response status must improve to close the previous event. Returns null if not set. For example, if this value is 3, a check whose response status changes from Error to OK closes the previous event and generates a new event with an OK status after the third consecutive occurrence of the status change.
Data type: Number
</td></tr><tr><td>
checks.interval
</td><td>
Amount of time in seconds to wait between check executions. For example, a value of 60 means that the check runs every 60 seconds.Data type: Number
</td></tr><tr><td>
checks.name
</td><td>
Name of the check.Data type: String
</td></tr><tr><td>
checks.sys\_id
</td><td>
Sys\_id of the check. The [POST /agents/update/check/\{check\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md) endpoint takes this value to update the sandbox copy.Data type: String
Table: Check Instances \[sn\_agent\_check\]
</td></tr><tr><td>
checks.timeout
</td><td>
Amount of time, in seconds, after which the check execution stops when no output is returned. For example, a value of 60 means that when the check execution doesn't return a value for 60 seconds, the execution stops.Data type: String
</td></tr><tr><td>
cred\_alias
</td><td>
Credential name.Data type: String
Table: Credentials \[discovery\_credentials\]
</td></tr><tr><td>
credential\_alias
</td><td>
Sys\_id of the credential alias.Data type: String
Table: Connection &amp; Credential Aliases \[sys\_alias\]
</td></tr><tr><td>
filter
</td><td>
Filter restricting the policy's checks to monitor only the specified criteria. Data type: String
</td></tr><tr><td>
interval
</td><td>
Amount of time in seconds to wait between policy checks. For example, a value of 60 means that the check runs every 60 seconds.**Note:** The value of the **checks.interval** property overrides the value configured in this field.
Data type: Number
</td></tr><tr><td>
monitored\_ci\_group
</td><td>
Name of the [CMDB groups](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/servicenow-platform/cmdb-groups.md) associated with the policy.This field is only applied if the value of the **monitored\_ci\_type\_group** property is true.
Data type: String
Table: CMDB Groups \[cmdb\_group\]
</td></tr><tr><td>
monitored\_ci\_script
</td><td>
Script for monitoring CIs.This field is only applied if the value of the **policies.monitored\_ci\_type\_script** property is true.
Data type: String
</td></tr><tr><td>
monitored\_ci\_type\_filter
</td><td>
Flag that indicates whether filtering by CI type is enabled. The CI type is listed in the **table** property.Valid values:
-   true: Filtering by checks group is enabled.-   false: Filtering by checks group is disabled.
Data type: Boolean
</td></tr><tr><td>
monitored\_ci\_type\_group
</td><td>
Flag that indicates whether monitoring by CMDB group type is enabled.Valid values:
-   true: CMDB group type is enabled.-   false: CMDB group type is disabled.
Data type: Boolean
</td></tr><tr><td>
monitored\_ci\_type\_script
</td><td>
Flag that indicates whether the script for monitoring CIs is enabled.Valid values:
-   true: Script for monitoring CIs is enabled.-   false: Script for monitoring CIs is disabled.
Data type: Boolean
</td></tr><tr><td>
name
</td><td>
Name of the policy.Data type: String
</td></tr><tr><td>
publish\_status
</td><td>
Indicates whether the policy is published. Possible values:
-   Draft: Policy has not been published and is editable using the update endpoints.-   Published: Policy is published. The draft \(sandbox copy\) and published copy are identical.-   Published\*: Policy is published, but the draft copy \(sandbox view\) has changes not found in the published copy.
Data type: String
</td></tr><tr><td>
params
</td><td>
List of objects containing information of check parameters. These results only display if the **X-Include-Check-Params** header parameter is set to true.Data type: Array of Objects

Table: Check Parameters \[sn\_agent\_check\_param\]
</td></tr><tr><td>
params.active
</td><td>
Flag that indicates whether the check parameter is active.Valid values:
-   true: Check parameter is active.-   false: Check parameter is inactive.
Data type: Boolean
</td></tr><tr><td>
params.flag
</td><td>
Parameter flag to use during check invocation.Data type: String
</td></tr><tr><td>
params.mandatory
</td><td>
Flag that indicates whether this check is mandatory.Valid values:
-   true: This check is mandatory.-   false: This check is optional.
Data type: Boolean
</td></tr><tr><td>
params.name
</td><td>
Name of the parameter.Data type: String
</td></tr><tr><td>
params.sys\_id
</td><td>
Sys\_id of the parameter listed in the Check Parameters \[sn\_agent\_check\_param\] table. The [POST /agents/update/check\_param/\{param\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md) endpoint takes this value to update the sandbox copy.Data type: String
</td></tr><tr><td>
params.value
</td><td>
Value of the parameter.Data type: String
</td></tr><tr><td>
params.value\_required
</td><td>
Flag that indicates whether the information provided by the value property is required.Valid values:
-   true: The value property is required.-   false: The value property is null or not required.
Data type: Boolean
</td></tr><tr><td>
secure\_params
</td><td>
List of objects containing information of check secure parameters. For more information, see [Create a secure parameter for a check](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/acc-create-secure-params.md). These results only display if the **X-Include-Check-Params** header parameter is set to true.Data type: Array of Objects

Table: Check Secure Parameters \[sn\_agent\_check\_secure\_param\]
</td></tr><tr><td>
secure\_params.active
</td><td>
Flag that indicates whether the check secure parameter is active.Valid values:
-   true: The check secure parameter is active.-   false: The check secure parameter is inactive.
Data type: Boolean
</td></tr><tr><td>
secure\_params.name
</td><td>
Name of the secure parameter.Data type: String
</td></tr><tr><td>
secure\_params.order
</td><td>
Order in which the parameter is sent to the check command/script.Data type: Number
</td></tr><tr><td>
secure\_params.sys\_id
</td><td>
Sys\_id of the record. The [POST /agents/update/check\_secure\_param/\{param\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md) endpoint takes this value to update the sandbox copy.Data type: String
Table: Check Secure Parameter \[sn\_agent\_check\_secure\_param\]
</td></tr><tr><td>
sys\_id
</td><td>
Sys\_id of the policy. The [POST /agents/update/policy/\{policy\_id\}](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-apis/agnt_clnt_cll-api.md) endpoint takes this value to update the sandbox copy.Data type: String
Table: Policies \[sn\_agent\_policy\]
</td></tr><tr><td>
sys\_updated\_on
</td><td>
Date and time that the policy was last updated.Data type: String
</td></tr><tr><td>
table
</td><td>
Monitored CI-type field on the policy. This field is only applied if **monitored\_ci\_type\_filter** is true.Data type: String
</td></tr></tbody></table>### cURL request
The following shows how to get information of the Docker Container Metrics policy.

Output:

## Agent Client Collector - GET /agents/\{agent\_id\}/restart
Restarts a specified agent with alive/up status.
If Agent Client Collector performance issues occur, you can restart the agent. Manual restart is supported in the following environments:
-   Linux-based agents using `systemd`-   Windows agents
### URL format
`/api/sn_agent/agents/{agent_id}/restart`
### Supported request parameters
<table id="table_oyt_cd3_dpb" class="rest_api_path_parameters"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
agent\_id
</td><td>
Unique ID of an agent listed in the Agent ID column of the Agent Client Collectors \[sn\_agent\_cmdb\_ci\_agent\] table. For a list of agent IDs and other details, run the GET /agents/list endpoint.
 Data type: String
</td></tr></tbody></table>|Name|Description||----|-----------||None| |
|Name|Description||----|-----------||None| |
### Headers
The following request and response headers apply to this HTTP action only, or apply to this action in a distinct way. For a list of general headers used in the REST API, see [Supported REST API headers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Header|Description||------|-----------||Accept|Data format of the response body. Only supports **application/json**.|
|Header|Description||------|-----------||None| |
### Status codes
The following status codes apply to this HTTP action. For a list of possible status codes used in the REST API, see [REST API HTTP response codes](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/api-reference/rest-api-explorer/c_RESTAPI.md).
|Status code|Description||-----------|-----------||200|Successful. The request was successfully processed.||403|The user does not have the agent\_client\_collector\_admin role.||404|No record found with the provided sys\_id or this agent does not support restart.|
### Response body parameters \(JSON\)
<table id="table_owl_zyc_z4b"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
message
</td><td>
Message containing operation success or failure results.Data type: String
</td></tr></tbody></table>### cURL request
The following example shows how to restart an agent.

Output:

## Agent Client Collector - POST /agents/check\_defs/\{check\_def\_id\}/run
Runs a check against the given configuration item.
To stop a background check, use the request ID provided in the GET /agents/exec/background/stop/\{request\_id\} API.
### URL format
`/api/sn_agent/agents/check_defs/{check_def_id}/run`
### Supported request parameters
|Name|Description||----|-----------||check\_def\_id|Sys\_id of a check definition in the Check Definitions \[sn\_agent\_check\_def\] table.|
|Name|Description||----|-----------||None| |
<table id="table_cvh_5gq_wqb" class="rest_api_request_body"><thead><tr><th>
Name
</th><th>
Description
</th></tr></thead><tbody><tr><td>
params
</td><td>
Map of parameter names and values. These settings can be used to override the parameter records of the check definition and its specified values. ```"params": {  "<parameter name>": "String"}