Get Site Installation Package: get_site_installation_package

This topic details API to get the Site Installation package. For manual download from the N-sight RMM dashboard, please see:
Service name: get_site_installation_package

URL

https://SERVER/api/?apikey=yourAPItoken&service=get_site_installation_package

&required_parameters=required_parameters

[&optional_parameters=optional_parameters]

Description

Creates a Site Installation Package based on the specified installer type. Where successful a package is created and downloaded.

By default this package is based on the latest General Availability Agent unless the beta=true parameter is used. In this case the Site Installation Package contains the current Release Candidate Agent.

Support for Mac and Linux Site Installation Packages was introduced in Dashboard v2020.05.21. To maintain previously configured API calls, the Site Installation Package defaults to Windows where an os parameter is not provided.

Parameters
Post Variable Description Type Required Options Default
endcustomerid Unique identifier of client Note: endcustomerid = clientid from list_clients integer yes 0 0
siteid Site ID integer yes 0 0
mode Mode string no authenticate
downloadgp
downloadrwbuild
0
proxyenabled Proxy enabled boolean no 0 0
proxyhost Proxy Host string no 0 0
proxyport Proxy Port integer no 0 0
proxyusername Proxy Username string no 0 0
proxypassword Proxy Password string no 0 0
describe Returns a description of the service. boolean no true 0
os Operating System to download the package for:
windows, mac or linux.
string yes windows
mac
linux
0
type Type of installer to download:
remote_worker (Windows, Mac, Linux) or group_policy (Windows only).
string yes remote_worker
group_policy
0
beta Download the current beta (RC) Agent version if set to true. boolean no true
false
false

Example Service Call =get_site_installation_package

https://SERVER/api/?apikey=yourAPItoken&service=get_site_installation_package&endcustomerid=ENDCUSTOMERID&siteid=SITEID&os=OS&type=TYPE

Example Response: Success
<?xml version="1.0"?>
	<result created="2015-07-22T10:58:38+01:00" host="SERVER" status="FAIL">
	<data> 
		<success>1</success> 
		<siteid>123</siteid> 
	</data> 
</result> 
Example Response: Failure
<?xml version="1.0"?>
	<result created="2015-07-22T10:58:38+01:00" host="SERVER" status="FAIL">
	<error>
		<errorcode>4</errorcode>
		<message>Invalid value for parameter: PARAMETER</message>
	</error>
</result>

 

Field Descriptions

No xml returned on success, file returned on success

 

Example Associated Service Calls
Parameter Call URL Format
SiteID list_sites https://SERVER/api/?apikey=yourAPItoken&service=list_sites&clientid=CLIENTID
EndcustomerID list_clients https://SERVER/api/?apikey=yourAPItoken&service=list_clients