Create a custom list | HUMAN Documentation

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

1 { 2 "message": "success", 3 "result": true, 4 "content": { 5 "_id": "64f8b12345678901234567ab", 6 "account_id": "642be969c2186cae012347b8", 7 "name": "Suspicious Users Blocklist", 8 "status": "active", 9 "created_by": "admin@humansecurity.com", 10 "created_at": "2023-09-01T10:00:00Z", 11 "updated_at": "2023-09-01T15:30:00Z", 12 "updated_by": "admin@humansecurity.com", 13 "size": 150, 14 "description": "List of users flagged for suspicious activity", 15 "usedBy": [ 16 { 17 "rule_id": "d668491a-f8f8-4b92-a280-c437b4411e0e", 18 "name": "Blocklist Rule", 19 "status": "active" 20 } 21 ], 22 "last_inserted_time": "2023-09-01T14:00:00Z" 23 } 24 }

Create a new custom list.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired>=1 character

Name of the custom list

descriptionstringOptional

Optional description of the custom list

Response

Custom list created successfully

messagestring

Response message

resultboolean

Indicates if the request was successful

contentobject or null

Authentication

Request

Response

Errors