Skip to main content
POST
Check an agent tool call before running it

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.

Headers

X-Blindsight-App-Id
string

UUID of the App the traffic belongs to. Optional: a key limited to one App, or a workspace with exactly one App, uses that App. A key limited to several Apps must send it.

Body

application/json
tool_name
string
required
Maximum string length: 200
arguments
any

Tool arguments: any JSON value. Defaults to an empty object.

session_id
string
Maximum string length: 200
source_app
string
Maximum string length: 128
provider
string
Maximum string length: 32
model
string
Maximum string length: 128
metadata
object

Response

Verdict and reasons

uuid
string
required

Event identifier. Empty when event logging is off.

verdict
enum<string>
required
Available options:
allow,
redact,
block
reasons
object[]
required

The rules that applied.

redacted_arguments
any
required

The arguments with personal data masked.

pii
object
required
arg_bytes
integer
required

Size of the JSON-serialised arguments in bytes.

latency_ms
integer
required