Create custom list identifiers | HUMAN Documentation

Add multiple identifiers to a custom list in bulk. If duplicate identifier/value combinations are provided, they will be skipped and counted in the duplicated field.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

listIdstringRequiredformat: "^[0-9a-fA-F]{24}$"

The unique identifier of the custom list

Request

This endpoint expects a list of objects.

identifierenumRequired

Type of identifier

valuestringRequired

The identifier value

Response

Identifiers created successfully

messagestring

Response message

resultboolean

Indicates if the request was successful

contentobject or null

1	import requests
2
3	url = "https://console.humansecurity.com/api/v1/botDefender/customLists/64f8b12345678901234567ab/identifiers"
4
5	headers = {
6	"Authorization": "Bearer <token>",
7	"Content-Type": "application/json"
8	}
9
10	response = requests.post(url, headers=headers)
11
12	print(response.json())

1	{
2	"message": "success",
3	"result": true,
4	"content": {
5	"added": 3,
6	"total": 4,
7	"duplicated": 1
8	}
9	}

Authentication

Path parameters

Request

Response

Errors