Get Distribution URL

Cortex XDR REST API

post /public_api/v1/distributions/get_dist_url

Get the distribution URL for downloading the installation package.

Required license: Cortex XDR Prevent or Cortex XDR Pro per Endpoint

CURL
curl -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ "https://api-yourfqdn/public_api/v1/distributions/get_dist_url" \ -d '{ "request_data" : { "distribution_id" : "distribution_id", "package_type" : "package_type" } }'
Response
{ "reply": { "distribution_url": "<DOWNLOAD_URL>" } }
Request
Body
optional
Example: {"request_data":{"distribution_id":"","package_type":"x86"}}
request_data
required
distribution_id
required
String
Installation package ID.
package_type
required
String

A string representing the type of installation package. Select one of the following valid keywords and values:

  • upgrade Package type should match the distribution type or platform:
  • sh: For Linux
  • rpm: For Linux
  • deb: For Linux
  • pkg: For Mac
  • x86: For Windows
  • x64: For Windows
Responses

Successful response

Body
reply
optional
distribution_url
optional
String
URL for downloading the installation package.

Bad Request. Got an invalid JSON.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example: {"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.

Unauthorized access. An issue occurred during authentication. This can indicate an incorrect key, id, or other invalid authentication parameters.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example: {"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.

Unauthorized access. User does not have the required license type to run this API.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example: {"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.

Forbidden access. The provided API Key does not have the required RBAC permissions to run this API.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example: {"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.

Internal server error. A unified status for API communication type errors.

Body
The query result upon error.
err_code
optional
String
HTTP response code.
err_msg
optional
String
Error message.
Example: {"line": 1, "column": 19, "message": "no viable alternative at input '|alter2'"}
err_extra
optional
String
Additional information describing the error.