Rate Limit Rules
Get all Rate Limit Rules in a configuration
Rate Limit Rules retrieved successfully
GET /api/v4.0/conf/{config}/rate-limit-rules HTTP/1.1
Host:
Accept: */*
Rate Limit Rules retrieved successfully
{
"total": 1,
"items": [
{
"action": "text",
"active": true,
"description": "text",
"exclude": {
"relation": "OR",
"tags": [
"text"
]
},
"global": true,
"id": "text",
"include": {
"relation": "OR",
"tags": [
"text"
]
},
"is_action_ban": true,
"key": 1,
"last_activated": 1,
"name": "text",
"pairwith": null,
"tags": [
"text"
],
"threshold": 1,
"timeframe": 1,
"ttl": 1
}
]
}
Update an existing set of Rate Limit Rules for a configuration
Rate Limit Rules updated successfully
Validation Error
PUT /api/v4.0/conf/{config}/rate-limit-rules HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 298
[
{
"action": "text",
"active": true,
"description": "text",
"exclude": {
"relation": "OR",
"tags": [
"text"
]
},
"global": true,
"id": "text",
"include": {
"relation": "OR",
"tags": [
"text"
]
},
"is_action_ban": true,
"key": 1,
"last_activated": 1,
"name": "text",
"pairwith": null,
"tags": [
"text"
],
"threshold": 1,
"timeframe": 1,
"ttl": 1
}
]
{
"message": "Successfully updated entry"
}
Create a complete set of Rate Limit Rules for a configuration
Rate Limit Rules created successfully
Validation Error
POST /api/v4.0/conf/{config}/rate-limit-rules HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 298
[
{
"action": "text",
"active": true,
"description": "text",
"exclude": {
"relation": "OR",
"tags": [
"text"
]
},
"global": true,
"id": "text",
"include": {
"relation": "OR",
"tags": [
"text"
]
},
"is_action_ban": true,
"key": 1,
"last_activated": 1,
"name": "text",
"pairwith": null,
"tags": [
"text"
],
"threshold": 1,
"timeframe": 1,
"ttl": 1
}
]
{
"message": "Successfully created entry"
}
Delete all Rate Limit Rules in a configuration
Rate Limit Rules deleted successfully
Validation Error
DELETE /api/v4.0/conf/{config}/rate-limit-rules HTTP/1.1
Host:
Accept: */*
{
"message": "Successfully deleted entry"
}
Get a Rate Limit Rule from the specified configuration
Rate Limit Rule retrieved successfully
Validation Error
GET /api/v4.0/conf/{config}/rate-limit-rules/{entry_id} HTTP/1.1
Host:
Accept: */*
{
"action": "text",
"active": true,
"description": "text",
"exclude": {
"relation": "OR",
"tags": [
"text"
]
},
"global": true,
"id": "text",
"include": {
"relation": "OR",
"tags": [
"text"
]
},
"is_action_ban": true,
"key": 1,
"last_activated": 1,
"name": "text",
"pairwith": null,
"tags": [
"text"
],
"threshold": 1,
"timeframe": 1,
"ttl": 1
}
Update an individual Rate Limit Rule within a configuration
Rate Limit Rule updated successfully
Validation Error
PUT /api/v4.0/conf/{config}/rate-limit-rules/{entry_id} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 296
{
"action": "text",
"active": true,
"description": "text",
"exclude": {
"relation": "OR",
"tags": [
"text"
]
},
"global": true,
"id": "text",
"include": {
"relation": "OR",
"tags": [
"text"
]
},
"is_action_ban": true,
"key": 1,
"last_activated": 1,
"name": "text",
"pairwith": null,
"tags": [
"text"
],
"threshold": 1,
"timeframe": 1,
"ttl": 1
}
{
"message": "Successfully updated entry"
}
Create an individual Rate Limit Rule within a configuration
Rate Limit Rule created successfully
Validation Error
POST /api/v4.0/conf/{config}/rate-limit-rules/{entry_id} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 296
{
"action": "text",
"active": true,
"description": "text",
"exclude": {
"relation": "OR",
"tags": [
"text"
]
},
"global": true,
"id": "text",
"include": {
"relation": "OR",
"tags": [
"text"
]
},
"is_action_ban": true,
"key": 1,
"last_activated": 1,
"name": "text",
"pairwith": null,
"tags": [
"text"
],
"threshold": 1,
"timeframe": 1,
"ttl": 1
}
{
"message": "Successfully created entry"
}
Delete an individual Rate Limit Rule from the specified configuration
Rate Limit Rule deleted successfully
Validation Error
DELETE /api/v4.0/conf/{config}/rate-limit-rules/{entry_id} HTTP/1.1
Host:
Accept: */*
{
"message": "Successfully deleted entry"
}
Get list of versions of Rate Limit Rules in a configuration
Rate Limit Rules version list retrieved successfully
Validation Error
GET /api/v4.0/conf/{config}/rate-limit-rules/versions HTTP/1.1
Host:
Accept: */*
{
"total": 1,
"items": [
{
"author": "text",
"email": "[email protected]",
"message": "text",
"date": "2025-08-20T11:42:47.452Z",
"version": "42bcc1282349db1e5791484c3d69420b1d8a8bc1",
"parents": [
"f44073242093228b45bff7eb7a065559fa9b46aa"
]
}
]
}
Get a specific version of a Rate Limit Rule
Rate Limit Rule retrieved successfully
Validation Error
GET /api/v4.0/conf/{config}/rate-limit-rules/versions/{version} HTTP/1.1
Host:
Accept: */*
{
"total": 1,
"items": [
{
"action": "text",
"active": true,
"description": "text",
"exclude": {
"relation": "OR",
"tags": [
"text"
]
},
"global": true,
"id": "text",
"include": {
"relation": "OR",
"tags": [
"text"
]
},
"is_action_ban": true,
"key": 1,
"last_activated": 1,
"name": "text",
"pairwith": null,
"tags": [
"text"
],
"threshold": 1,
"timeframe": 1,
"ttl": 1
}
]
}
Set a previous Rate Limit Rule version to be the current one
Rate Limit Rule reversion was successful
Validation Error
PUT /api/v4.0/conf/{config}/rate-limit-rules/versions/{version}/revert HTTP/1.1
Host:
Accept: */*
{
"message": "Successfully updated entry"
}
Last updated
Was this helpful?