Update workspace settings
curl --request PUT \
--url https://api.blindsight.example.com/api/runtime-security/config \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"enabled": true,
"block_threshold": 0.85,
"redact_threshold": 0.55,
"max_text_length": 32000,
"log_events": true,
"pre_prompt": "<string>",
"pre_prompt_placement": "prepend",
"agentic": {
"tool_allowlist": [
"<string>"
],
"tool_denylist": [
"<string>"
],
"max_arg_bytes": 32000,
"allow_private_network": false
},
"file_scanning_enabled": true,
"file_unredactable_action": "block",
"pseudonymize_enabled": false,
"pseudonymize_labels": {},
"pseudonymize_retention_days": 30,
"dlp_fail_mode": "open",
"dlp_fail_mode_locked": false,
"dlp_protect_unsanctioned": false,
"dlp_host_rule_overrides": [
{}
]
}
'import requests
url = "https://api.blindsight.example.com/api/runtime-security/config"
payload = {
"enabled": True,
"block_threshold": 0.85,
"redact_threshold": 0.55,
"max_text_length": 32000,
"log_events": True,
"pre_prompt": "<string>",
"pre_prompt_placement": "prepend",
"agentic": {
"tool_allowlist": ["<string>"],
"tool_denylist": ["<string>"],
"max_arg_bytes": 32000,
"allow_private_network": False
},
"file_scanning_enabled": True,
"file_unredactable_action": "block",
"pseudonymize_enabled": False,
"pseudonymize_labels": {},
"pseudonymize_retention_days": 30,
"dlp_fail_mode": "open",
"dlp_fail_mode_locked": False,
"dlp_protect_unsanctioned": False,
"dlp_host_rule_overrides": [{}]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
enabled: true,
block_threshold: 0.85,
redact_threshold: 0.55,
max_text_length: 32000,
log_events: true,
pre_prompt: '<string>',
pre_prompt_placement: 'prepend',
agentic: {
tool_allowlist: ['<string>'],
tool_denylist: ['<string>'],
max_arg_bytes: 32000,
allow_private_network: false
},
file_scanning_enabled: true,
file_unredactable_action: 'block',
pseudonymize_enabled: false,
pseudonymize_labels: {},
pseudonymize_retention_days: 30,
dlp_fail_mode: 'open',
dlp_fail_mode_locked: false,
dlp_protect_unsanctioned: false,
dlp_host_rule_overrides: [{}]
})
};
fetch('https://api.blindsight.example.com/api/runtime-security/config', 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://api.blindsight.example.com/api/runtime-security/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'enabled' => true,
'block_threshold' => 0.85,
'redact_threshold' => 0.55,
'max_text_length' => 32000,
'log_events' => true,
'pre_prompt' => '<string>',
'pre_prompt_placement' => 'prepend',
'agentic' => [
'tool_allowlist' => [
'<string>'
],
'tool_denylist' => [
'<string>'
],
'max_arg_bytes' => 32000,
'allow_private_network' => false
],
'file_scanning_enabled' => true,
'file_unredactable_action' => 'block',
'pseudonymize_enabled' => false,
'pseudonymize_labels' => [
],
'pseudonymize_retention_days' => 30,
'dlp_fail_mode' => 'open',
'dlp_fail_mode_locked' => false,
'dlp_protect_unsanctioned' => false,
'dlp_host_rule_overrides' => [
[
]
]
]),
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://api.blindsight.example.com/api/runtime-security/config"
payload := strings.NewReader("{\n \"enabled\": true,\n \"block_threshold\": 0.85,\n \"redact_threshold\": 0.55,\n \"max_text_length\": 32000,\n \"log_events\": true,\n \"pre_prompt\": \"<string>\",\n \"pre_prompt_placement\": \"prepend\",\n \"agentic\": {\n \"tool_allowlist\": [\n \"<string>\"\n ],\n \"tool_denylist\": [\n \"<string>\"\n ],\n \"max_arg_bytes\": 32000,\n \"allow_private_network\": false\n },\n \"file_scanning_enabled\": true,\n \"file_unredactable_action\": \"block\",\n \"pseudonymize_enabled\": false,\n \"pseudonymize_labels\": {},\n \"pseudonymize_retention_days\": 30,\n \"dlp_fail_mode\": \"open\",\n \"dlp_fail_mode_locked\": false,\n \"dlp_protect_unsanctioned\": false,\n \"dlp_host_rule_overrides\": [\n {}\n ]\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.blindsight.example.com/api/runtime-security/config")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"enabled\": true,\n \"block_threshold\": 0.85,\n \"redact_threshold\": 0.55,\n \"max_text_length\": 32000,\n \"log_events\": true,\n \"pre_prompt\": \"<string>\",\n \"pre_prompt_placement\": \"prepend\",\n \"agentic\": {\n \"tool_allowlist\": [\n \"<string>\"\n ],\n \"tool_denylist\": [\n \"<string>\"\n ],\n \"max_arg_bytes\": 32000,\n \"allow_private_network\": false\n },\n \"file_scanning_enabled\": true,\n \"file_unredactable_action\": \"block\",\n \"pseudonymize_enabled\": false,\n \"pseudonymize_labels\": {},\n \"pseudonymize_retention_days\": 30,\n \"dlp_fail_mode\": \"open\",\n \"dlp_fail_mode_locked\": false,\n \"dlp_protect_unsanctioned\": false,\n \"dlp_host_rule_overrides\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blindsight.example.com/api/runtime-security/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"enabled\": true,\n \"block_threshold\": 0.85,\n \"redact_threshold\": 0.55,\n \"max_text_length\": 32000,\n \"log_events\": true,\n \"pre_prompt\": \"<string>\",\n \"pre_prompt_placement\": \"prepend\",\n \"agentic\": {\n \"tool_allowlist\": [\n \"<string>\"\n ],\n \"tool_denylist\": [\n \"<string>\"\n ],\n \"max_arg_bytes\": 32000,\n \"allow_private_network\": false\n },\n \"file_scanning_enabled\": true,\n \"file_unredactable_action\": \"block\",\n \"pseudonymize_enabled\": false,\n \"pseudonymize_labels\": {},\n \"pseudonymize_retention_days\": 30,\n \"dlp_fail_mode\": \"open\",\n \"dlp_fail_mode_locked\": false,\n \"dlp_protect_unsanctioned\": false,\n \"dlp_host_rule_overrides\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"enabled": true,
"block_threshold": 0.85,
"redact_threshold": 0.55,
"max_text_length": 32000,
"log_events": true,
"pre_prompt": "<string>",
"pre_prompt_placement": "prepend",
"agentic": {
"tool_allowlist": [
"<string>"
],
"tool_denylist": [
"<string>"
],
"max_arg_bytes": 32000,
"allow_private_network": false
},
"file_scanning_enabled": true,
"file_unredactable_action": "block",
"pseudonymize_enabled": false,
"pseudonymize_labels": {},
"pseudonymize_retention_days": 30,
"dlp_fail_mode": "open",
"dlp_fail_mode_locked": false,
"dlp_protect_unsanctioned": false,
"dlp_host_rule_overrides": [
{}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}Configuration
Update workspace settings
Toggling enabled scales the firewall service. If the control
plane refuses the change, the database flag is rolled back and
the response is 503.
PUT
/
api
/
runtime-security
/
config
Update workspace settings
curl --request PUT \
--url https://api.blindsight.example.com/api/runtime-security/config \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"enabled": true,
"block_threshold": 0.85,
"redact_threshold": 0.55,
"max_text_length": 32000,
"log_events": true,
"pre_prompt": "<string>",
"pre_prompt_placement": "prepend",
"agentic": {
"tool_allowlist": [
"<string>"
],
"tool_denylist": [
"<string>"
],
"max_arg_bytes": 32000,
"allow_private_network": false
},
"file_scanning_enabled": true,
"file_unredactable_action": "block",
"pseudonymize_enabled": false,
"pseudonymize_labels": {},
"pseudonymize_retention_days": 30,
"dlp_fail_mode": "open",
"dlp_fail_mode_locked": false,
"dlp_protect_unsanctioned": false,
"dlp_host_rule_overrides": [
{}
]
}
'import requests
url = "https://api.blindsight.example.com/api/runtime-security/config"
payload = {
"enabled": True,
"block_threshold": 0.85,
"redact_threshold": 0.55,
"max_text_length": 32000,
"log_events": True,
"pre_prompt": "<string>",
"pre_prompt_placement": "prepend",
"agentic": {
"tool_allowlist": ["<string>"],
"tool_denylist": ["<string>"],
"max_arg_bytes": 32000,
"allow_private_network": False
},
"file_scanning_enabled": True,
"file_unredactable_action": "block",
"pseudonymize_enabled": False,
"pseudonymize_labels": {},
"pseudonymize_retention_days": 30,
"dlp_fail_mode": "open",
"dlp_fail_mode_locked": False,
"dlp_protect_unsanctioned": False,
"dlp_host_rule_overrides": [{}]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
enabled: true,
block_threshold: 0.85,
redact_threshold: 0.55,
max_text_length: 32000,
log_events: true,
pre_prompt: '<string>',
pre_prompt_placement: 'prepend',
agentic: {
tool_allowlist: ['<string>'],
tool_denylist: ['<string>'],
max_arg_bytes: 32000,
allow_private_network: false
},
file_scanning_enabled: true,
file_unredactable_action: 'block',
pseudonymize_enabled: false,
pseudonymize_labels: {},
pseudonymize_retention_days: 30,
dlp_fail_mode: 'open',
dlp_fail_mode_locked: false,
dlp_protect_unsanctioned: false,
dlp_host_rule_overrides: [{}]
})
};
fetch('https://api.blindsight.example.com/api/runtime-security/config', 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://api.blindsight.example.com/api/runtime-security/config",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'enabled' => true,
'block_threshold' => 0.85,
'redact_threshold' => 0.55,
'max_text_length' => 32000,
'log_events' => true,
'pre_prompt' => '<string>',
'pre_prompt_placement' => 'prepend',
'agentic' => [
'tool_allowlist' => [
'<string>'
],
'tool_denylist' => [
'<string>'
],
'max_arg_bytes' => 32000,
'allow_private_network' => false
],
'file_scanning_enabled' => true,
'file_unredactable_action' => 'block',
'pseudonymize_enabled' => false,
'pseudonymize_labels' => [
],
'pseudonymize_retention_days' => 30,
'dlp_fail_mode' => 'open',
'dlp_fail_mode_locked' => false,
'dlp_protect_unsanctioned' => false,
'dlp_host_rule_overrides' => [
[
]
]
]),
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://api.blindsight.example.com/api/runtime-security/config"
payload := strings.NewReader("{\n \"enabled\": true,\n \"block_threshold\": 0.85,\n \"redact_threshold\": 0.55,\n \"max_text_length\": 32000,\n \"log_events\": true,\n \"pre_prompt\": \"<string>\",\n \"pre_prompt_placement\": \"prepend\",\n \"agentic\": {\n \"tool_allowlist\": [\n \"<string>\"\n ],\n \"tool_denylist\": [\n \"<string>\"\n ],\n \"max_arg_bytes\": 32000,\n \"allow_private_network\": false\n },\n \"file_scanning_enabled\": true,\n \"file_unredactable_action\": \"block\",\n \"pseudonymize_enabled\": false,\n \"pseudonymize_labels\": {},\n \"pseudonymize_retention_days\": 30,\n \"dlp_fail_mode\": \"open\",\n \"dlp_fail_mode_locked\": false,\n \"dlp_protect_unsanctioned\": false,\n \"dlp_host_rule_overrides\": [\n {}\n ]\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.blindsight.example.com/api/runtime-security/config")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"enabled\": true,\n \"block_threshold\": 0.85,\n \"redact_threshold\": 0.55,\n \"max_text_length\": 32000,\n \"log_events\": true,\n \"pre_prompt\": \"<string>\",\n \"pre_prompt_placement\": \"prepend\",\n \"agentic\": {\n \"tool_allowlist\": [\n \"<string>\"\n ],\n \"tool_denylist\": [\n \"<string>\"\n ],\n \"max_arg_bytes\": 32000,\n \"allow_private_network\": false\n },\n \"file_scanning_enabled\": true,\n \"file_unredactable_action\": \"block\",\n \"pseudonymize_enabled\": false,\n \"pseudonymize_labels\": {},\n \"pseudonymize_retention_days\": 30,\n \"dlp_fail_mode\": \"open\",\n \"dlp_fail_mode_locked\": false,\n \"dlp_protect_unsanctioned\": false,\n \"dlp_host_rule_overrides\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blindsight.example.com/api/runtime-security/config")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"enabled\": true,\n \"block_threshold\": 0.85,\n \"redact_threshold\": 0.55,\n \"max_text_length\": 32000,\n \"log_events\": true,\n \"pre_prompt\": \"<string>\",\n \"pre_prompt_placement\": \"prepend\",\n \"agentic\": {\n \"tool_allowlist\": [\n \"<string>\"\n ],\n \"tool_denylist\": [\n \"<string>\"\n ],\n \"max_arg_bytes\": 32000,\n \"allow_private_network\": false\n },\n \"file_scanning_enabled\": true,\n \"file_unredactable_action\": \"block\",\n \"pseudonymize_enabled\": false,\n \"pseudonymize_labels\": {},\n \"pseudonymize_retention_days\": 30,\n \"dlp_fail_mode\": \"open\",\n \"dlp_fail_mode_locked\": false,\n \"dlp_protect_unsanctioned\": false,\n \"dlp_host_rule_overrides\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"enabled": true,
"block_threshold": 0.85,
"redact_threshold": 0.55,
"max_text_length": 32000,
"log_events": true,
"pre_prompt": "<string>",
"pre_prompt_placement": "prepend",
"agentic": {
"tool_allowlist": [
"<string>"
],
"tool_denylist": [
"<string>"
],
"max_arg_bytes": 32000,
"allow_private_network": false
},
"file_scanning_enabled": true,
"file_unredactable_action": "block",
"pseudonymize_enabled": false,
"pseudonymize_labels": {},
"pseudonymize_retention_days": 30,
"dlp_fail_mode": "open",
"dlp_fail_mode_locked": false,
"dlp_protect_unsanctioned": false,
"dlp_host_rule_overrides": [
{}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "<string>"
}Authorizations
ApiKeyAuthBlindsightKeyAuthSessionCookieAuth
Blindsight workspace API key (ak_live_…). Use this header for the
scan API and the OpenAI proxy routes. The required permission
scope is runtime_security.scan for scan endpoints,
runtime_security.view for read-only analytics, and
runtime_security.manage for configuration changes.
Body
application/json
Required range:
0 <= x <= 1Required range:
0 <= x <= 1Required range:
256 <= x <= 200000Maximum string length:
20000Available options:
prepend, append, sandwich Show child attributes
Show child attributes
Scan file uploads as well as prompt text.
What happens when a file contains PII or secrets and its format has no in-file redactor.
Available options:
block, allow Replace detected values with reversible surrogates instead of a placeholder, so the reply can be restored on the way back.
Per-label overrides for which categories are pseudonymized.
How long a surrogate stays resolvable back to its value.
What the endpoint agent does when it cannot reach this API. closed stops the traffic it cannot get a verdict for.
Available options:
open, closed Prevents a device changing its own fail mode.
Inspect and pseudonymize traffic to AI services nobody has approved, rather than blocking them.
Per-host rules that override the built-in AI host list, each naming a host pattern, how to match it, and what to do.
Response
New settings (after persistence)
Required range:
0 <= x <= 1Required range:
0 <= x <= 1Required range:
256 <= x <= 200000Maximum string length:
20000Available options:
prepend, append, sandwich Show child attributes
Show child attributes
Scan file uploads as well as prompt text.
What happens when a file contains PII or secrets and its format has no in-file redactor.
Available options:
block, allow Replace detected values with reversible surrogates instead of a placeholder, so the reply can be restored on the way back.
Per-label overrides for which categories are pseudonymized.
How long a surrogate stays resolvable back to its value.
What the endpoint agent does when it cannot reach this API. closed stops the traffic it cannot get a verdict for.
Available options:
open, closed Prevents a device changing its own fail mode.
Inspect and pseudonymize traffic to AI services nobody has approved, rather than blocking them.
Per-host rules that override the built-in AI host list, each naming a host pattern, how to match it, and what to do.