Skip to main content
GET
Read the workspace settings

Authorizations

X-API-Key
string
header
required

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.

Response

Current settings

enabled
boolean
default:true
max_text_length
integer
default:32000

Characters. A scan field longer than this is refused with 413.

Required range: 256 <= x <= 200000
log_events
boolean
default:true
pre_prompt
string | null
Maximum string length: 20000
pre_prompt_placement
enum<string>
default:prepend
Available options:
prepend,
append,
sandwich
agentic
object
file_scanning_enabled
boolean
default:true

Scan file uploads as well as prompt text.

file_unredactable_action
enum<string>
default:block

What happens when a file contains personal data and its format has no in-file redactor.

Available options:
block,
allow
pseudonymize_enabled
boolean
default:false

Replace detected values with reversible surrogates instead of a placeholder, so the reply can be restored on the way back.

pseudonymize_labels
object

Per-label overrides for which categories are pseudonymized.

pseudonymize_retention_days
integer
default:30

How long a surrogate stays resolvable back to its value.

Required range: 1 <= x <= 365
dlp_fail_mode
enum<string>
default:open

What the endpoint agent does when it cannot inspect an AI destination. closed refuses the connection.

Available options:
open,
closed
dlp_fail_mode_locked
boolean
default:false

Prevents a device changing its own fail mode.

dlp_protect_unsanctioned
boolean
default:false

The posture towards AI services nobody has approved.

dlp_host_rule_overrides
object[]

Per-host rules that override the built-in AI host list, each naming a host pattern, how to match it, and what to do.

identity_mode
enum<string>
default:named

Whether people and devices are named, shown as codes, or shown as totals only.

Available options:
named,
pseudonymised,
aggregated