The new docs.trellix.com features a modernized UI and AI-powered conversational search. Content is currently available in English, with additional languages launching in early November 2026. We hope you enjoy the updated experience.

REST API call to import excluded plug-and-play device templates

Prev Next

Use this REST API call to send a request to create or override existing excluded plug-and-play devices.

POST request URL

https://<epo_server_name:port>/rest/dlp/definitions/excludedPnPDevice/import

Where, epo_server_name:port is the server IP address and port number.

Request Parameters

Request Parameters

Parameter name

Description

Required

Values

Authorization

User credentials for ePO - On-prem.

Required

Parameter name

Description

Required

Values

override

If true: overrides the existing definition.

If false: If the definition name exists, the operation fails.

Required

Boolean

body

CSV file containing records to be imported.

Required

File

Sample POST request URL

https://172.27.108.53:8443/rest/dlp/definitions/excludedPnPDevice/import

Sample cURL command

curl -k -v -X POST 'https://172.27.108.53:8443/rest/dlp/definitions/excludedPnPDevice/import' -u '<user>:<password>' -F 'override="false"' -F 'body=@"/path/to/file/fileName.csv"'

Sample request (multipart/form-data)

{
      "override": false,
      "body": the CSV file 
}

Sample response

Import completed

Status and error codes

List of HTTP status codes returned for the query.

Code

Description

200 OK

The response returns a string.

400 Bad Request

Returns a bad request if:

  • Override value is missing or empty.

  • Body is missing or empty.

  • CSV Headers do not match or are incorrect.

  • Number of records in the CSV file are greater than 20000.

  • Device template name field is empty.

  • Device template name length is greater than 100.

  • Device template name already exists or is not unique.

  • Failed to import excluded plug-and-play devices.

404 Not Found

Incorrect ePO - On-prem URL.

500 Internal Server Error

An error on the server side that failed the request. See the Trellix ePO - On prem orion.log file for more details about the error.