Replace the integration's risk-classification cutpoints
https://api.isnotai.comAuthenticate with Authorization: Bearer aik_v1_... (preferred) or the x-api-key header. Keys are region-bound. Authentication
The integration’s risk thresholds drive the labels and counts of its own responses, on the raw botScore: GET /v1/users (riskLevel, botSessionCount, mediumSessionCount) and GET /v1/analytics (uniqueBots, timeSeries[].botCount, topOrigins[].botPercentage and the botDetection breakdown, whose high-confidence band starts at max(botAt, 0.90)). A saved change applies to the next request. What stays on fixed platform rules does not follow them: the session status flagged and the botOnly filter of GET /v1/sessions (the platform’s 0.70 bot flag), BotDetected webhooks and GET /v1/stats botsDetected. Defaults: mediumAt 40, botAt 70.
Full replace of both cutpoints (idempotent - safe to retry). Validation: integers in [0, 100], botAt >= mediumAt + 5.
Body
Responses
Any authenticated route can also return 401 (missing or invalid key), 429 RATE_LIMITED (edge rate limit; Retry-After is an integer number of seconds), and 5xx errors, even where not listed below. See Error Handling and Rate Limits.
Payload of RiskThresholdsResponse
Payload of ErrorEnvelope
Payload of ErrorEnvelope
Payload of ErrorEnvelope
curl --request PUT \
--url https://api.isnotai.com/v1/settings/risk-thresholds \
--header 'Authorization: Bearer aik_v1_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{"thresholds":{"mediumAt":100,"botAt":100}}'
import requests
url = "https://api.isnotai.com/v1/settings/risk-thresholds"
payload = { "thresholds": {
"mediumAt": 100,
"botAt": 100
} }
headers = {
"Authorization": "Bearer aik_v1_YOUR_API_KEY",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.json())
const fetch = require('node-fetch');
const url = 'https://api.isnotai.com/v1/settings/risk-thresholds';
const options = {
method: 'PUT',
headers: {
Authorization: 'Bearer aik_v1_YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: '{"thresholds":{"mediumAt":100,"botAt":100}}'
};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Put,
RequestUri = new Uri("https://api.isnotai.com/v1/settings/risk-thresholds"),
Headers =
{
{ "Authorization", "Bearer aik_v1_YOUR_API_KEY" },
},
Content = new StringContent("{\"thresholds\":{\"mediumAt\":100,\"botAt\":100}}")
{
Headers =
{
ContentType = new MediaTypeHeaderValue("application/json")
}
}
};
using (var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}
Sent to the API as Authorization: Bearer aik_v1_.... Held only in this tab's input element; re-enter on each browser tab. The docs site never receives or stores it.
{
"thresholds": {
"mediumAt": 100,
"botAt": 100
}
}
{
"data": {
"thresholds": {
"mediumAt": 100,
"botAt": 100
},
"updatedAt": "2024-01-01T00:00:00Z",
"updatedBy": "string"
}
}
{
"error": {
"code": "string",
"message": "string",
"details": {}
}
}
{
"error": {
"code": "string",
"message": "string",
"details": {}
}
}
{
"error": {
"code": "string",
"message": "string",
"details": {}
}
}