Read 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.
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
curl --request GET \
--url https://api.isnotai.com/v1/settings/risk-thresholds \
--header 'Authorization: Bearer aik_v1_YOUR_API_KEY'
import requests
url = "https://api.isnotai.com/v1/settings/risk-thresholds"
headers = {"Authorization": "Bearer aik_v1_YOUR_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())
const fetch = require('node-fetch');
const url = 'https://api.isnotai.com/v1/settings/risk-thresholds';
const options = {method: 'GET', headers: {Authorization: 'Bearer aik_v1_YOUR_API_KEY'}};
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.Get,
RequestUri = new Uri("https://api.isnotai.com/v1/settings/risk-thresholds"),
Headers =
{
{ "Authorization", "Bearer aik_v1_YOUR_API_KEY" },
},
};
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.
{
"data": {
"thresholds": {
"mediumAt": 100,
"botAt": 100
},
"updatedAt": "2024-01-01T00:00:00Z",
"updatedBy": "string"
}
}
{
"error": {
"code": "string",
"message": "string",
"details": {}
}
}