Check an agent tool call before running it
curl --request POST \
--url https://platform.blindsight.io/api/runtime-security/scan/tool-call \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"tool_name": "send_email",
"arguments": {
"to": "jane.doe@example.com",
"body": "Hello"
}
}
'import requests
url = "https://platform.blindsight.io/api/runtime-security/scan/tool-call"
payload = {
"tool_name": "send_email",
"arguments": {
"to": "jane.doe@example.com",
"body": "Hello"
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tool_name: 'send_email',
arguments: {to: 'jane.doe@example.com', body: JSON.stringify('Hello')}
})
};
fetch('https://platform.blindsight.io/api/runtime-security/scan/tool-call', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://platform.blindsight.io/api/runtime-security/scan/tool-call",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tool_name' => 'send_email',
'arguments' => [
'to' => 'jane.doe@example.com',
'body' => 'Hello'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://platform.blindsight.io/api/runtime-security/scan/tool-call"
payload := strings.NewReader("{\n \"tool_name\": \"send_email\",\n \"arguments\": {\n \"to\": \"jane.doe@example.com\",\n \"body\": \"Hello\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://platform.blindsight.io/api/runtime-security/scan/tool-call")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"tool_name\": \"send_email\",\n \"arguments\": {\n \"to\": \"jane.doe@example.com\",\n \"body\": \"Hello\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.blindsight.io/api/runtime-security/scan/tool-call")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tool_name\": \"send_email\",\n \"arguments\": {\n \"to\": \"jane.doe@example.com\",\n \"body\": \"Hello\"\n }\n}"
response = http.request(request)
puts response.read_body{
"uuid": "e4a9c2b7-1f60-4d83-8a35-6b7c0d2e9f18",
"verdict": "redact",
"reasons": [],
"redacted_arguments": {
"to": "<EMAIL>",
"body": "Hello"
},
"pii": {
"count": 1,
"categories": [
"email"
]
},
"arg_bytes": 52,
"latency_ms": 3
}{
"detail": "<string>"
}{
"detail": {
"code": "QUOTA_EXCEEDED",
"message": "<string>",
"resets_at": "<string>",
"upgrade_url": "<string>"
}
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}Scan
Check an agent tool call before running it
Evaluates the tool name and arguments against the workspace and App
tool policy and masks personal data in the arguments. Part of the
agentic guardrails module; a workspace without it gets 404.
Requires the runtime:scan permission. Rate limit: 200 requests per
second per API key.
POST
/
api
/
runtime-security
/
scan
/
tool-call
Check an agent tool call before running it
curl --request POST \
--url https://platform.blindsight.io/api/runtime-security/scan/tool-call \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"tool_name": "send_email",
"arguments": {
"to": "jane.doe@example.com",
"body": "Hello"
}
}
'import requests
url = "https://platform.blindsight.io/api/runtime-security/scan/tool-call"
payload = {
"tool_name": "send_email",
"arguments": {
"to": "jane.doe@example.com",
"body": "Hello"
}
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
tool_name: 'send_email',
arguments: {to: 'jane.doe@example.com', body: JSON.stringify('Hello')}
})
};
fetch('https://platform.blindsight.io/api/runtime-security/scan/tool-call', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://platform.blindsight.io/api/runtime-security/scan/tool-call",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'tool_name' => 'send_email',
'arguments' => [
'to' => 'jane.doe@example.com',
'body' => 'Hello'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://platform.blindsight.io/api/runtime-security/scan/tool-call"
payload := strings.NewReader("{\n \"tool_name\": \"send_email\",\n \"arguments\": {\n \"to\": \"jane.doe@example.com\",\n \"body\": \"Hello\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://platform.blindsight.io/api/runtime-security/scan/tool-call")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"tool_name\": \"send_email\",\n \"arguments\": {\n \"to\": \"jane.doe@example.com\",\n \"body\": \"Hello\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://platform.blindsight.io/api/runtime-security/scan/tool-call")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"tool_name\": \"send_email\",\n \"arguments\": {\n \"to\": \"jane.doe@example.com\",\n \"body\": \"Hello\"\n }\n}"
response = http.request(request)
puts response.read_body{
"uuid": "e4a9c2b7-1f60-4d83-8a35-6b7c0d2e9f18",
"verdict": "redact",
"reasons": [],
"redacted_arguments": {
"to": "<EMAIL>",
"body": "Hello"
},
"pii": {
"count": 1,
"categories": [
"email"
]
},
"arg_bytes": 52,
"latency_ms": 3
}{
"detail": "<string>"
}{
"detail": {
"code": "QUOTA_EXCEEDED",
"message": "<string>",
"resets_at": "<string>",
"upgrade_url": "<string>"
}
}{
"detail": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}Authorizations
Blindsight API key (ak_...). The permissions it needs are listed in
the API description and on each operation: runtime:scan for scan and
proxy routes, runtime:events:read for events, analytics, drift,
health and service status, runtime:config:read to read the
configuration and runtime:config:write to change it.
Headers
Body
application/json
Response
Verdict and reasons

