Open in ChatGPT
View as Markdown

Replace the integration's risk-classification cutpoints

PUT /v1/settings/risk-thresholds
Base URL 
https://api.isnotai.com

Authenticate with Authorization: Bearer aik_v1_... (preferred) or the x-api-key header. Keys are region-bound. Authentication

Available Regions 2 regions

Full replace of both cutpoints (idempotent - safe to retry). Validation: integers in [0, 100], botAt >= mediumAt + 5.

application/json

Body

thresholds
object Required
Show 2 thresholds attributes Hide thresholds attributes
mediumAt
integer(int32) Required

Score at or above which a session is classified medium risk. Integer in [0, 100].

Minimum value is 0, Maximum value is 100.
botAt
integer(int32) Required

Score at or above which a session is classified bot. Integer in [0, 100]; must be >= mediumAt + 5.

Minimum value is 0, Maximum value is 100.

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.

200 application/json

Payload of RiskThresholdsResponse

Show 1 response attribute Hide response attributes
data
object
Show 3 data attributes Hide data attributes
thresholds
object
Show 2 thresholds attributes Hide thresholds attributes
mediumAt
integer(int32) Required

Score at or above which a session is classified medium risk. Integer in [0, 100].

Minimum value is 0, Maximum value is 100.
botAt
integer(int32) Required

Score at or above which a session is classified bot. Integer in [0, 100]; must be >= mediumAt + 5.

Minimum value is 0, Maximum value is 100.
updatedAt
string(date-time)
updatedBy
string
400 application/json

Payload of ErrorEnvelope

Show 1 response attribute Hide response attributes
error
object
Show 3 error attributes Hide error attributes
code
string Required
message
string Required
details
object Required

Always present and null unless the error carries field-level context (validation errors set details.field to the offending parameter name).

401 application/json

Payload of ErrorEnvelope

Show 1 response attribute Hide response attributes
error
object
Show 3 error attributes Hide error attributes
code
string Required
message
string Required
details
object Required

Always present and null unless the error carries field-level context (validation errors set details.field to the offending parameter name).

PUT /v1/settings/risk-thresholds 
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);
}

Try it

Collapse

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.

Request examples 
{
  "thresholds": {
    "mediumAt": 100,
    "botAt": 100
  }
}
200 Response examples 
{
  "data": {
    "thresholds": {
      "mediumAt": 100,
      "botAt": 100
    },
    "updatedAt": "2024-01-01T00:00:00Z",
    "updatedBy": "string"
  }
}
400 Response examples 
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}
401 Response examples 
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}