Cisco AMP for Endpoints API

POST /v1/install_packages

Description

JSON Body Parameters

Name Type Description
group_guid GUID Required.
product_name String Required. Allowed values: windows, mac, linux, or android.
scan_on_install Boolean Required for windows, mac, and linux. Ignored for android.
redistributable Boolean Required for windows. Ignored for mac, linux, and android.
product_variant_attributes.name, product_variant_attributes.version String Required for linux. Ignored for windows, mac, and android. Allowed values correspond to the Linux product variants seen on the "Download Connector" page.

Response

On success, the response body contains information pertaining to the created install package and the response header is 200 OK. The data.download_url field of the response body is a link that can be used to download a new connector based off of the created install package.

On error, the response header is 400 Bad Request and contains an errors object with details of the failure.

Write
Preview

Examples

creates a windows install package
creates a mac install package
creates a linux install package
creates an android install package

creates a windows install package

Request

Requires Authorization
POST /v1/install_packages
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
content-length: 124

cURL Edit, then copy and paste on your terminal

curl -X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
-H 'content-length: 124' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-d '{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"windows","scan_on_install":true,"redistributable":true}' \
-u YOUR_API_CLIENT_ID \
'https://api.amp.cisco.com/v1/install_packages'
Body
{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"windows","scan_on_install":true,"redistributable":true}
      

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1957
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2787
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"5c692a423ce4805884f4383c6b3d4137"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000
{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/install_packages"
    }
  },
  "data": {
    "download_url": "https://console.qa1.immunet.com/install_packages/882fb1ec-eaee-44f7-b409-efbb392bc336/download?product=WindowsProduct",
    "group_guid": "a4a983ef-91df-428f-9b08-1e88ec5357df",
    "install_token": "882fb1ec-eaee-44f7-b409-efbb392bc336",
    "installer_version": "7.3.9.20091",
    "product": "windows",
    "redistributable": true,
    "scan_on_install": true
  }
}

creates a mac install package

Request

Requires Authorization
POST /v1/install_packages
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
content-length: 97

cURL Edit, then copy and paste on your terminal

curl -X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
-H 'content-length: 97' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-d '{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"mac","scan_on_install":true}' \
-u YOUR_API_CLIENT_ID \
'https://api.amp.cisco.com/v1/install_packages'
Body
{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"mac","scan_on_install":true}
      

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1957
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2786
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"cf734d838daecef9812110790c9e99a6"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000
{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/install_packages"
    }
  },
  "data": {
    "download_url": "https://console.qa1.immunet.com/install_packages/2265f06e-9a01-44e4-b209-ea3ce4a30f66/download?product=MacProduct",
    "group_guid": "a4a983ef-91df-428f-9b08-1e88ec5357df",
    "install_token": "2265f06e-9a01-44e4-b209-ea3ce4a30f66",
    "installer_version": "1.16.0.829",
    "product": "mac",
    "scan_on_install": true
  }
}

creates a linux install package

Request

Requires Authorization
POST /v1/install_packages
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
content-length: 166

cURL Edit, then copy and paste on your terminal

curl -X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
-H 'content-length: 166' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-d '{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"linux","scan_on_install":false,"product_variant_attributes":{"name":"RHEL/CentOS","version":"7"}}' \
-u YOUR_API_CLIENT_ID \
'https://api.amp.cisco.com/v1/install_packages'
Body
{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"linux","scan_on_install":false,"product_variant_attributes":{"name":"RHEL/CentOS","version":"7"}}
      

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1956
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2785
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"32faf6ad9cffcf2b66c1fb314c988a82"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000
{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/install_packages"
    }
  },
  "data": {
    "download_url": "https://console.qa1.immunet.com/install_packages/559542a3-3f1e-405a-b305-f55579bb084f/download?product=LinuxProduct&product_variant_id=d2db2d9b-6c06-4cca-951a-e25489d19b5c",
    "group_guid": "a4a983ef-91df-428f-9b08-1e88ec5357df",
    "install_token": "559542a3-3f1e-405a-b305-f55579bb084f",
    "installer_version": "1.15.4.754",
    "product": "linux",
    "product_variant": "RHEL/CentOS 7",
    "scan_on_install": false
  }
}

creates an android install package

Request

Requires Authorization
POST /v1/install_packages
Headers
accept: application/json
content-type: application/json
accept-encoding: identity
authorization: Basic FILTERED
content-length: 78

cURL Edit, then copy and paste on your terminal

curl -X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'accept-encoding: identity' \
-H 'content-length: 78' \
--compressed -H 'Accept-Encoding: gzip, deflate' \
-d '{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"android"}' \
-u YOUR_API_CLIENT_ID \
'https://api.amp.cisco.com/v1/install_packages'
Body
{"group_guid":"a4a983ef-91df-428f-9b08-1e88ec5357df","product_name":"android"}
      

Response

Shortened for readability

content-type: application/json; charset=utf-8
transfer-encoding: chunked
status: 200 OK
x-ratelimit-limit: 3000
x-ratelimit-reset: 1956
referrer-policy: strict-origin-when-cross-origin
x-ratelimit-remaining: 2784
x-permitted-cross-domain-policies: none
x-download-options: noopen
etag: W/"edcd567d2cde3596ab4696fc660af49d"
x-frame-options: SAMEORIGIN
x-ratelimit-resetdate: 2021-05-05T23:55:49Z
strict-transport-security: max-age=31536000
{
  "version": "v1.2.0",
  "metadata": {
    "links": {
      "self": "https://api.amp.cisco.com/v1/install_packages"
    }
  },
  "data": {
    "download_url": "https://console.qa1.immunet.com/install_packages/6f2550a9-952c-4a88-890d-0c5f64745e74/download?product=AndroidProduct",
    "group_guid": "a4a983ef-91df-428f-9b08-1e88ec5357df",
    "install_token": "6f2550a9-952c-4a88-890d-0c5f64745e74",
    "installer_version": "2.1.0.14",
    "product": "android",
    "scan_on_install": false
  }
}