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}
ParameterTypeDescriptionOptionsDefault
describeBooleanOptional. Returns a description of the service.00
checkidNumberThe ID of the Check you want to clear.00
private_noteStringTechnical (private) note00
public_noteStringClient-facing note00

Optional parameters

Add optional parameters immediately after the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=add_check_note&optional_parameters={parameter-value}
ParameterDescriptionTypeRequiredOptionsDefault
describeReturns a description of the service.booleannotrue0

Determine parameter values

Use the following associated service calls to determine parameter values.

ParameterCallURL Format
checkidlist_checkshttps://{SERVER}/api/?apikey={yourAPIkey}&service=list_checks&deviceid=DEVICEID
deviceidlist_devices_at_clienthttps://{SERVER}/api/?apikey={yourAPIkey}&service=list_devices_at_client&clientid=CLIENTID&devicetype=server
list_servershttps://{SERVER}/api/?apikey={yourAPIkey}&service=list_servers&siteid=SITEID
list_workstationshttps://{SERVER}/api/?apikey={yourAPIkey}&service=list_workstations&siteid=SITEID
siteidlist_siteshttps://{SERVER}/api/?apikey={yourAPIkey}&service=list_sites&clientid=CLIENTID
clientidlist_clientshttps://{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

FieldTypeCan Be EmptyDescription
checkidintegernoThe unique ID of the Check the note is added to