--- title: "REST API to import a dictionary" slug: "rest-api-to-import-a-dictionary" tags: ["Product Usage", "DLP 11.12.x"] updated: 2026-09-09T08:08:00Z published: 2026-09-09T08:08:00Z canonical: "docs.trellix.com/rest-api-to-import-a-dictionary" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # REST API to import a dictionary You can use this REST API call to send a request to create or override an existing dictionary. ### POST request URL `https://<epo_server_name:port>/rest/dlp/definitions/dictionary/import` Where, `epo_server_name:port` is the server IP address and port number. ### Request Parameters | Parameter name | Description | Required | Values | | --- | --- | --- | --- | | **Authorization** | User credentials for ePO - On-prem. | Required | | **Form Parameters (multipart/form-data)** | Parameter name | Description | Required | Values | | --- | --- | --- | --- | | name | If the name of the definition exists, the current properties are overridden, else a new definition is created. | Required | String | | description | Description of the definition. | Optional | String | | override | If true: Overrides the existing definition. If false: If the definition name exists, the operation fails. | Required | Boolean | | body | CSV file containing records that has to be imported. | Required | File | **Sample POST request URL** `https://172.27.108.53:8443/rest/dlp/definitions/dictionary/import` **Sample cURL command** `curl -k -v -X POST 'https://172.27.108.53:8443/rest/dlp/definitions/dictionary/import' -u '<user>:<password>' -F 'name="DictionaryName"' -F 'description="Description"' -F 'override="false"' -F 'body=@"/path/to/file/fileName.csv"'` ### Sample request parameters (multipart/form-data) ``` {      "name": "DictionaryName",      "description": "Description",      "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** | Returns a message after a successful import of the dictionary. | | **400 Bad Request** | Returns a bad request if: - Dictionary name is missing or empty. - Length of the dictionary name is greater than or equal to 100. - Length of the description is greater than or equal to 100 - Override is missing or empty. - Body is missing or empty. - Catalog item name exists. - CSV headers do not match or are incorrect. - Number of records in the CSV file are greater than 20000. - Dictionary import failed. | | **404 Not Found** | Incorrect ePO - On-prem URL. | | **500 Internal Server Error** | An error on the server side that failed the request. See the ePO - On-prem `orion.log` file for more details about the error. |