Add a Check Note
Service name: add_check_note
Base URL
https://{SERVER}/api/?apikey={yourAPIkey}&service=add_check_note
Description
Add a public/private note to a check based on the provided public_note and/or private_note value.
Parameters
Required parameters
Add required parameters immediately after the base URL.
https://{SERVER}/api/?apikey={yourAPIkey}&service=add_check_note&required_parameters={parameter-value}
Parameter | Type | Description | Options | Default |
---|---|---|---|---|
describe | Boolean | Optional. Returns a description of the service. | 0 | 0 |
checkid | Number | The ID of the Check you want to clear. | 0 | 0 |
private_note | String | Technical (private) note | 0 | 0 |
public_note | String | Client-facing note | 0 | 0 |
Optional parameters
Add optional parameters immediately after the base URL.
https://{SERVER}/api/?apikey={yourAPIkey}&service=add_check_note&optional_parameters={parameter-value}
Parameter | Description | Type | Required | Options | Default |
---|---|---|---|---|---|
describe | Returns a description of the service. | boolean | no | true | 0 |
Determine parameter values
Use the following associated service calls to determine parameter values.
Parameter | Call | URL Format |
---|---|---|
checkid | list_checks | https://{SERVER} /api/?apikey={yourAPIkey} &service=list_checks&deviceid=DEVICEID |
deviceid | list_devices_at_client | https://{SERVER} /api/?apikey={yourAPIkey} &service=list_devices_at_client&clientid=CLIENTID&devicetype=server |
list_servers | https://{SERVER} /api/?apikey={yourAPIkey} &service=list_servers&siteid=SITEID | |
list_workstations | https://{SERVER} /api/?apikey={yourAPIkey} &service=list_workstations&siteid=SITEID | |
siteid | list_sites | https://{SERVER} /api/?apikey={yourAPIkey} &service=list_sites&clientid=CLIENTID |
clientid | list_clients | https://{SERVER} /api/?apikey={yourAPIkey} &service=list_clients |
Examples
Add a check note
https://{SERVER}/api/?apikey={yourAPIkey}&service=add_check_note&checkid=CHECKID&private_note=PRIVATEMESSAGE&public_note=PUBLICMESSAGE
Example response
<?xml version="1.0"?>
<result created="2024-10-01T15:29:38+01:00" host="server" status="OK">
<message><![CDATA[Note Added]]></message>
</result>
Returned fields
Field | Type | Can Be Empty | Description |
---|---|---|---|
checkid | integer | no | The unique ID of the Check the note is added to |
Updated about 1 month ago