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

resultboolean

Indicates if the request was successful

messagestring

Response message

contentobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://console.humansecurity.com/api/v1/botDefender/customLists/64f8b12345678901234567ab/identifiers \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"identifier": "socketIps",
>	"value": "192.168.1.100"
>	},
>	{
>	"identifier": "socketIpASN",
>	"value": "AS158"
>	},
>	{
>	"identifier": "path",
>	"value": "test.example.com"
>	},
>	{
>	"identifier": "custom_param1",
>	"value": "test_param_1"
>	}
>	]'

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

$	curl -X POST https://console.humansecurity.com/api/v1/botDefender/customLists/64f8b12345678901234567ab/identifiers \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"identifier": "socketIps",
>	"value": "192.168.1.100"
>	},
>	{
>	"identifier": "socketIpASN",
>	"value": "AS158"
>	},
>	{
>	"identifier": "path",
>	"value": "test.example.com"
>	},
>	{
>	"identifier": "custom_param1",
>	"value": "test_param_1"
>	}
>	]'

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