Replace custom list identifiers | HUMAN Documentation

1 import requests 2 3 url = "https://console.humansecurity.com/api/v1/botDefender/customLists/64f8b12345678901234567ab/identifiers" 4 5 payload = { 6 "0": { 7 "identifier": "socketIps", 8 "value": "1.1.1.1" 9 }, 10 "1": { 11 "identifier": "socketIpASN", 12 "value": "AS158" 13 }, 14 "2": { 15 "identifier": "path", 16 "value": "test.com" 17 }, 18 "3": { 19 "identifier": "custom_param1", 20 "value": "custom_param 1" 21 }, 22 "4": { 23 "identifier": "custom_param2", 24 "value": "custom_param 2" 25 } 26 } 27 headers = { 28 "Authorization": "Bearer <token>", 29 "Content-Type": "application/json" 30 } 31 32 response = requests.put(url, json=payload, headers=headers) 33 34 print(response.json())

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

Replace all existing identifiers in a custom list with new ones.

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 replaced successfully

messagestring

Response message

resultboolean

Indicates if the request was successful

contentobject or null

Authentication

Path parameters

Request

Response

Errors