Update a custom list | HUMAN Documentation

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

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

Update name, description, or status of an existing custom list by its ID.

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 an object.

namestringOptional

Updated name of the custom list

descriptionstringOptional

Updated description of the custom list

statusenumOptional

Updated status of the custom list

Allowed values:

Response

Custom list updated successfully

messagestring

Response message

resultboolean

Indicates if the request was successful

contentlist of objects or null

Array containing the updated custom list

Authentication

Path parameters

Request

Response

Errors