Create a list

post https://{hostname}/etp-config/v3/configs/{configId}/lists

Creates a new list.

Path Params

configId

integer

required

A unique identifier for the configuration.

Query Params

includeDeleted

boolean

Defaults to false

Indicates if the result set includes deleted resources, false by default.

includeSpecialEntities

boolean

Defaults to false

Indicates if the results include special entities, false by default.

onlyWithGrantedAccess

boolean

Defaults to false

Indicates if the results include resources with granted access, false by default.

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Body Params

description

string

required

length ≥ 1

Describes the list.

listType

string

length ≥ 0

The list type. See List types for details on supported values.

name

string

required

length ≥ 1

Name of the list.

securityCategoryId

integer

required

≥ 1

The list's security category value. Either 1 for Malware, 2 for Phishing, 3 for C&C, 5 for DNS Exfiltration, 6 for Risky domains, or 7 for File sharing.

Responses

Language

Authentication

Remember to add your authentication credentials to run this code.

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://hostname/etp-config/v3/configs/configId/lists \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
 
1
200 OK

200Successful response.

400Validation error.

401Authentication error. See Get started for help setting up your API token.

403Insufficient permissions See Get started for help setting up your API token.

404Configuration not Found.