Skip to main content

Update Bot Rule

Updates an existing Bot Management Rule identified by ID.

Request

Request-Line

PUT /waap/v1.0/botManagementRule/{id} HTTP/1.1

Request Parameters

Path Parameters

ParameterTypeRequiredDescription
idintegerMandatoryUnique identifier assigned to the bot rule.

Body Parameters

ParameterTypeRequiredDescription
namestringOptionalThe name for a new rule. The name must have 1-26 characters. Valid characters: 0-9, A-Z, a-z, space, . (dot), _ (underline), - (hyphen), () (parentheses), * (asterisk) and + (plus sign). If not provided, the existing name will remain unchanged.
descriptionstringOptionalThe description can have 1-200 characters. If not provided, the existing description will remain unchanged.
silenceChallengeEnabledbooleanOptionalWhether to enable silence challenge. If not provided, the existing setting will remain unchanged.
silenceChallengeActionstringOptionalAction when silence challenge triggers. Must be "block" or "captcha". If not provided, the existing action remains.
ajaxEnabledbooleanOptionalWhether to enable AJAX behavior detection. If not provided, the existing setting will remain unchanged.
antiDebuggingEnabledbooleanOptionalWhether to enable anti-debugging behavior detection. If not provided, the existing setting will remain unchanged.
websitesinteger[]OptionalList of website IDs the rule applies to. Must contain at least one valid ID. If not provided, existing websites remain unchanged.

Response

Status Codes, Error Codes and Error Messages

Status CodeError CodeError Message
400Request.BadRequestBad request.
400Id.InvalidId is empty or invalid.
400Name.InvalidName is empty or invalid.
404BotManagementRule.NotFoundBot Management Rule is not found.
404Website.NotFoundWebsite is not found.

Examples

Update Bot Rule

Request

PUT /waap/v1.0/botManagementRule/40 HTTP/1.1

{
"name": "test111",
"description": "111",
"silenceChallengeEnabled": 1,
"silenceChallengeAction": "captcha",
"ajaxEnabled": true,
"antiDebuggingEnabled": true,
"websites": [
110,111
]
}